用途:编写或更新调用方所需的文档,内容以当前仓库及其已确认意图为依据。小规模说明无需访谈、覆盖台账或单独报告,只需选择与任务相关的模式。
主要模式:解释 API、命令、代码地图或架构时,检查其使用方与源码;创建或改进 README 时,以用户问题与可用的首次使用路径开头,保留有用深度;审计或搭建开源文档时,将现有文档与所需文档包对比,创建缺失文件,仅在授权范围内修改现有文件;初始化缺失的入口文档时,只创建明确请求的缺失文件,已存在路径报告为跳过;为其他上下文保留会话时,填写交接模板并按说明交付。这些是可选任务形态,不是连续阶段。
写作要求:确定受众、问题与现有文档负责人,复用已确认意图,仅询问会实质改变文档的缺失内容。阅读相关声明并对照代码、配置、命令帮助或可执行行为核实,使用调用方领域术语。较大范围需保留足够源码引用,披露已检查与仍未知的内容,不得暗示覆盖整个仓库。做最小有用编辑,解释非显而易见的规则、顺序与权衡。检查链接、示例及仓库适用的文档构建或校验器,删除空泛声明与冗余文字。返回变更路径与检查结果,以及未解决的事实缺口;仅在调用方要求或现有使用方需要时另写报告。
缺失文档初始化:只创建请求的缺失文档,如 PRODUCT.md、GOALS.md 或 AGENTS.md;冲突则跳过而非覆盖。核实创建路径并报告已创建、跳过与失败。初始化不安装工具、不运行 ao session bootstrap、不初始化 Git 或跟踪器、不启动运行时、不添加钩子,也不推断仓库工作流。AgentOps 判定存储仅在明确请求时创建。
会话交接:请求的交接记录可供另一上下文核实。填写每个字段,未观察到的事实写 unknown 并注明原因,调用方未观察的主张记为“stated, unverified”,绝不作为事实。交接模板包含目标与验收、已完成、失败或撤回、未决、停止状态、剩余额度、身份、续接等字段。ID 只记录观察到的身份;停止状态需从原生所有者读取,否则写 unknown;额度不因压缩、新会话或交接而重置。保留有信息量的失败与撤回主张。
目的地:新的 CDLC 交接、草稿或证明只写入选定的受保护外部非 Git 目的地;未选定则报告缺失路由且不创建回退文件。其他交接以调用方指定位置为准,写入后读回并返回确切路径;未指定位置则在响应中返回交接内容且不创建文件。复制元数据前检查来源、接收方/模型与目的地授权。
限制:撰写交接不改变跟踪器、Git、运行时或判定状态;原生调用方仍拥有授权结果,本模式不为其选择工作或决定续接。参考菜单仅在撰写相应文档时加载,提供示例与技术,不增加额外工作流关卡。