用途:document 是工作流中的文档阶段,要求在验证通过且用户批准结果后才运行,基于任务文档、测试报告和实际变更文件进行记录,并负责把任务在 TASKS.md 中标记为 Approved 后交接。
主要能力:按需在 docs/features/ 创建或更新面向开发者的功能文档;在 docs/guides/ 创建或更新面向用户的使用指南;在 docs/learnings/{ID}-{task-name}.md 写任务回顾;把可复用经验追加到 LEARNINGS.md(不重复已有条目);仅当任务确立了稳定的项目级约定时才更新 AGENTS.md。
使用方式:先读 AGENTS.md,解析任务 ID,读任务文档与测试报告,并用 git diff --name-only 确认实际变更文件,再按触发条件更新对应文档;随后写回顾并核对 TASKS.md,确保任务行处于 Approved 且不在 Planned、In Progress 或 Testing 中,若之前阶段遗漏移动则在此补齐并重新读取确认。运行时适配器可能将其暴露为斜杠命令、菜单动作或自然语言技能调用,可移植的阶段名称为 document。
适用场景:功能交付后的文档沉淀、缺陷修复后的排障说明、API 或 CLI 行为变更记录、项目约定与经验教训归档。
限制:仅应在验证通过并获用户批准后执行;文档必须依据任务文档、测试报告和实际变更文件,不得凭空生成;AGENTS.md 只写稳定的项目级指令;价格、平台支持等未在资料中提供。