用途：把仓库本地上下文当作一个整体来创建或润色，涵盖面向人的 README.md、面向智能体的 AGENTS.md（配 CLAUDE.md 符号链接），以及项目内已安装的 .agents/skills/<name>/SKILL.md。
主要能力：提供两种工作流，需二选一。polish 用于更新、刷新、同步、检查、清理、润色或修复已有上下文；create 用于创建或初始化缺失的 README.md / AGENTS.md。用户要求更新或未明确创建时默认 polish；明确说 create、init、initialize、generate、new 时默认 create。创建或安装新技能不在本技能范围，应改用 skills/create-skill 或用户的技能安装器。
使用方式：支持参数 path（限定仓库相对子树）、skill-name（过滤 .agents/skills 下已有技能，仅 polish 生效）、--root-only、--dry-run、--preserve、--minimal、--thorough/--full、--force（仅 create，不作用于技能）。未识别参数会在报告中列出，安全时按默认继续。
适用场景：维护仓库文档与智能体上下文一致性，修复事实漂移，清理可从清单或文件名推断的冗余内容，为有独立命令、安全规则或生成文件边界的子树建议嵌套 AGENTS.md。
限制：仅限当前 git 仓库内，不扫描或写入 ~/.agents、~/.claude 等全局目录；不创建、安装、删除或重命名技能；不把 skills/<name>/ 目录当作已安装技能；不重写普通 CLAUDE.md，仅处理指向同级 AGENTS.md 的符号链接；不编辑 CONTRIBUTING.md，仅建议合并；不自动提交。写入前执行根目录与家目录防护检查、记录 git status，写入后运行仓库的 Markdown 格式化/检查及技能调用元数据检查，并验证符号链接。具体命令与完整规则见资料原文。