用途:当 README 内容过时或需要与代码库同步时,用当前代码库状态、Git 历史和变更日志信息刷新已有 README.md。
主要能力与步骤:
- 检查 README 是否存在:在工作目录中匹配 README.md、readme.md、Readme.md;若未找到或实质内容少于 5 行,则提示未发现可用 README,调用 Skill: claude-coding:make-readme 并停止。
- 更新变更日志:调用 Skill: claude-coding:make-changelog,自动识别填充模式,仅补充上次记录以来缺失的版本;若仓库无 Git 历史则报错,记录后继续。
- 并行研究:同时启动三个 Explore 代理——审计现有 README 各章节(记录过时内容、未替换占位符、内容过薄章节、缺失的标准章节),扫描代码库(从 package.json、pyproject.toml、Cargo.toml、go.mod、.claude-plugin/plugin.json 获取项目名与版本、语言框架、目录结构、关键文件与额外文档),汇总 README 最后提交日期之后的 Git 提交并分类为新功能、破坏性变更、弃用、显著修复、其他。
- 读取更新后的 CHANGELOG.md 最新版本段落作为上下文。
- 按优先级做最小化编辑:版本号与徽章、过时内容、占位符清理、新功能、缺失章节、过薄章节。保留原有风格与结构。仅在文件改动超过 60% 时使用 Write。
- 输出报告:行数变化、更新章节、新增章节、删除章节及原因、版本变更、make-changelog 添加的版本。
限制与说明:依赖 Git 历史与代码库扫描;无 Git 历史时变更日志上下文缺失;不确定事项以实际扫描结果为准。具体调用方式与触发条件以该技能页面为准,其他细节暂未提供。