用途：把仓库本地上下文当作一个整体系统来创建或润色，包括面向人的 README.md、面向智能体的 AGENTS.md（配 CLAUDE.md 符号链接）、.agents/skills 下已安装的项目技能，以及其他承载持久指导的 Markdown 上下文文档（约定、命令目录、数据格式规则、工作流手册、参考资料等）。
主要能力：按用户意图选择工作流——更新、刷新、同步、修剪、润色、修复走 polish（references/brain-polish.md）；创建、初始化、生成走 create（references/create-docs.md）；审计、检查、审查、只建议不修改则用 polish 的 --dry-run 模式。创建或脚手架技能、安装/发现/移除/重命名技能均不在本技能范围内，应转用专门工作流。
使用方式：支持参数 path（限定仓库相对子树）、target（按技能名或 Markdown 路径筛选）、--root-only、--dry-run、--preserve、--minimal、--thorough/--full、--force。--minimal 与 --thorough/--full 同时出现时不写入并要求用户选择。运行前有仓库护栏脚本，拒绝在文件系统根目录、非 git 仓库、不支持的仓库根或嵌套于智能体配置仓库的根下运行；当仓库根为 $HOME/.agents、$HOME/.codex、$HOME/.claude 时，整个已安装 skills/ 树被排除，须在源目录编辑。
适用场景：需要让仓库文档与智能体上下文保持一致、减少无效 token、按加载链去重、把通用指导放父级、路径特定指导放嵌套、罕见流程放按需文档时。
限制：仅限文档工作，不得扩展到源码修改、技能创建或外部写入；删除 README.md、AGENTS.md、CLAUDE.md 或上下文文档目标需显式确认，--force 不授权删除；写入后需运行仓库定义的 Markdown 检查，并验证 CLAUDE.md 符号链接指向同级 AGENTS.md。具体模型提示指南与参考文件内容暂未提供。