用途:管理项目文档,包括 CLAUDE.md、AGENTS.md、README.md、CONTRIBUTING.md、DOCS.md 等上下文文件,适用于被要求更新、创建或初始化这些文件的场景。
主要能力:写入前先分析代码库结构、文件与模式,并核对现有文档中的声明是否与实际代码和命令一致,不盲目生成;在压缩上下文时保留请求权限、外部操作边界、证明标准与失败归因规则;不会顺带创建 CONTRIBUTING.md 或 DOCS.md;将跨领域约定保留在主上下文文件中,避免重复易变事实;报告实际编辑与检查内容,不声称未经验证的片段或外部标识符。
使用方式:支持参数 --dry-run(以 diff 预览、不写入)、--preserve(保留现有结构、只修正不准确处)、--minimal(快速、仅高层结构)、--thorough(深度分析所有文件)。覆盖前会以独占方式创建唯一相邻备份路径(如 mktemp FILE.backup.XXXXXX),复制源字节并报告备份路径;创建或复制失败则停止覆盖,且不替换或自动删除已有备份。操作后输出摘要,如 [OK] Updated AGENTS.md 及具体改动、[--] CONTRIBUTING.md not found (skipped)。
可移植性:AGENTS.md 是通用上下文文件,兼容 Claude Code、Codex、Kilocode。仅在 Initialize Context 或 Update Context Files 工作流中,若存在 CLAUDE.md 而无 AGENTS.md,需先经用户确认再执行 mv CLAUDE.md AGENTS.md,绝不作为其他任务的副作用迁移。CLAUDE.md 符号链接为可选兼容项;Claude Code v2.1.277 及以后在无 CLAUDE.md、.claude/CLAUDE.md 或 CLAUDE.local.md 时原生读取 AGENTS.md。
Monorepo:多包仓库需先读 monorepo.md;若一次扫描将创建或重写超过 3 个文件,应停止并列出计划目标,确认后再写入。
限制:资料未提供具体安装命令、收费或价格信息;部分引用文件(如 documentation-workflows.md、context-content-and-writing.md、init-agents.md 等)仅提及名称,未提供完整内容。