会话管理
本技能按当前Agent的能力执行，不限定产品。支持技能时按原生方式加载；不支持时，将本文件作为对话指令提供，再按需提供对应模块。文件读写与自动加载能力不足时，按通用使用方式完成可执行部分并说明限制。
涉及平台差异且当前能力信息不足时，按需读平台适配，解析规则文件、技能位置、文件权限和确认方式。已解析且未变化时复用，不每轮重做探测。
先识别用户要进入哪个阶段，只读取对应模块，不每次跑完三阶段。仅修改技能本身不等于执行初始化、整理或收尾。
| 意图 | 按需读取 | 行为 |
|---|---|---|
| 初始化项目、接续会话 | 会话初始化 | 初始化按原生命令或内置Codex本地化流程生成指南；接续只读取规则与当前状态 |
| 新建业务目录、归位或整理文件 | 文件夹管理 | 按已确认规范建目录或整理；不把进入目录当整理授权 |
| 明确交接、结束、更新HANDOFF | 交接与收尾 | neat-freak核对、弹窗确认清理、渐进式交接 |
模块间按实际需要引用，不循环调用总入口。
文件职责与层级
- 项目规则文件（通常
AGENTS.md，Claude Code新项目可用CLAUDE.md）：Agent长期规则、边界和规范入口。下文“规则文件”均指当前项目唯一的正文来源。 README.md：项目用途、目录规范、使用说明；长规范可放独立文档，两处引用同一来源。HANDOFF.md：当前目标、状态、未完成项和下一步；首次交接创建，不在初始化时预建。HISTORY.md：必要过程与恢复依据；有独立信息才创建，默认不读。
四文件指四种职责，不是初始化创建清单。Codex本地化初始化仅生成AGENTS.md，已有则不改；README及目录规范由文件夹管理按需维护。原生命令的规则文件名遵循宿主，不同时强制新建AGENTS与CLAUDE。新独立项目默认四文件位于根目录，不自动建 .handoff。已有项目沿用指定位置（含 .handoff/），不为统一外观迁移；同一范围只有一套权威入口。两处并存且权威不明时先确认。
检查范围不等于文档创建范围。普通子目录继承上级，不因本轮改动而自动生成四文件。只有独立项目、专属规则/说明、独立接续需求或项目明确要求时才建立相应文件，不要求四份成套出现。项目明确的分层约定优先，不擅自取消已有层级。
共同边界
先读适用的父级/本地规则（兼读已有AGENT.md，避免大小写重复），再按项目约定读当前交接；不能盲信旧记录。只读任务相关入口，不递归展开所有链接或全文加载HISTORY。目标、版本、边界和下一步明确后停止扩展读取。
写入前重读文件，合并其他会话的有效事项，保留范围外改动。创建、移动、删除、安装和外发分别遵循用户授权；不擅自建Git、提交、推送、修改机器记忆或启动自动化。不记录秘密、客户资料、隐藏推理或大段日志。
首次安装本套装或依赖缺失时读依赖配置；本机解析结果可记在 references/local-dependencies.md（可选、不随通用版分发），缺失或跨机器时重新发现，使用前检查可用性。安装流程不在每轮重复执行。
