用途:把仓库本地上下文作为一个整体系统来创建或润色,涵盖人类可读的README.md、面向智能体的AGENTS.md(及配套的CLAUDE.md符号链接)、项目内已安装技能、符合条件的源目录技能,以及承载持久指引的其他Markdown文档(约定、命令目录、数据格式规则、工作流手册等)。
主要能力:按单一工作流执行——更新/同步/润色/修复走polish,创建/初始化/重建走create,仅审计而不修改则用polish的--dry-run;技能创建与安装、发现、删除、重命名交给仓库自身的目录生命周期或专门的技能管理工作流。支持按子树(path)、技能名或文档路径(target)限定范围,并提供--dry-run、--preserve、--minimal、--thorough/--full、--force、--root-only等参数控制范围与写入行为。
使用方式:在仓库内运行时会先做守卫检查,包括拒绝在文件系统根目录执行、不在git仓库内则中止、对托管技能目录下的安装树禁止编辑。之后进行git感知的发现与工具路由,先快照git状态,识别候选文件并解析技能frontmatter,再按选定的reference执行写入。
适用场景:需要统一仓库文档与智能体上下文、同步README与AGENTS.md、校验技能元数据、核对CLAUDE.md符号链接有效性时。
限制:写入前需明确授权,删除README/AGENTS/CLAUDE.md等目标须额外确认,--force不能授权删除;只在文档范围内操作,不扩展到源码修改或外部写入;必须遵循仓库已定义的校验命令;若所需指引无法获取则在写入前停止。具体命令与内部细节以原资料为准。