用途:在代码提交并创建 PR 后,对项目 Markdown 文档做交付后同步,适用于同步文档、更新文档、记录变更、生成发布说明等场景。该技能原为 Claude Code 设计,后适配 Codex CLI;在 Codex 中交叉引用使用已安装技能名而非 /octo:* 斜杠命令,并使用当前 Codex shell 与子代理工具。
主要能力:扫描项目根目录下最多两层深度的 .md 文件(跳过 node_modules、.git、vendor、.claude 等目录),上限 30 个文件,超出会警告;用 git diff 对照变更,自动修正路径、数量、版本号、表格条目、导入路径等事实性内容;检测叙述性、理念性、安全性章节并标记为需用户确认,不自动编辑;对 CHANGELOG 做面向用户收益的措辞润色,只追加不删除;检查版本号、功能列表、徽章、链接、命令与技能数量等跨文档一致性;检查文档可发现性,标记无入链的孤立文档;根据 diff 中新增或移除的 TODO/FIXME/HACK 更新 TODOS.md;最后提交文档变更并更新 PR 描述。
使用方式:作为 flow-deliver 的子步骤,在验证与评审完成后调用;也可独立触发,如用户说“sync docs”“update documentation after merge”“document changes from last release”。执行时先发现文档、读取内容,再运行 git diff --stat HEAD~1 或与基线分支比较,随后按步骤自动更新、检测风险变更、润色 CHANGELOG、检查一致性与可发现性、更新 TODOS.md,最后用 git add 与 git commit 提交,并通过 gh pr view 更新 PR 正文。
限制:最多扫描 30 个文档文件;绝不覆盖 CHANGELOG,只追加;修改叙述或理念章节前必须询问用户;SECURITY.md 与 CONTRIBUTING.md 除版本号外不做自动修改;不声称某提供方、模型或宿主子代理可用,除非当前会话已暴露。具体收费、价格、平台支持等信息暂未提供。