Wiki 变更日志助手
从 Git 历史生成分类清晰的结构化变更日志。
技能要求先检查 git remote,并在继续前询问用户确认本地或远程仓库;远程时提供提交和文件引用,体现了范围控制与来源透明。未说明敏感数据处理、权限边界、回滚机制或外部网络失败处理,因此未满分。
步骤顺序清晰,涵盖日志读取、分类和面向用户的摘要;但“最近”的时间范围、无远程时的具体行为、仓库不可用时的诊断反馈,以及链接中的 BRANCH 如何确定都未定义。静态审查且无该技能专属执行证据,受上限限制。
触发语句和主要使用场景明确,适合提交历史与变更摘要;但输入、输出结构、非适用场景和异常仓库边界不够明确,也没有中文输出或中国大陆网络环境说明,因此扣分。
SKILL.md 具备名称、描述、MIT 许可、作者和版本元数据,并按解析、触发、流程、约束组织内容;但缺少示例、FAQ、已知限制、变更记录、维护责任和更新路径。README 与 CI 仅提供仓库级背景,不能替代技能专属文档。
核心流程能够支持按时间和类型生成面向用户的变更日志,并要求突出破坏性变更;但没有固定输出格式、示例或验证结果,链接规则也可能需要人工补充,因此只能确认部分核心价值。
技能正文提供了可审计的明确步骤,仓库还显示存在通用测试与 CI;但提供的测试不覆盖 wiki-changelog 的关键路径,也没有该技能的真实执行结果或第三方复核,故证据覆盖有限。
- 该技能依赖本地 git 历史和可能的远程仓库访问;未定义 git 不可用、远程不可达或仓库为空时的明确降级与错误信息。
- 输出格式没有结构化规范或示例,生成结果的一致性和直接可用性需要人工复核。
- 未提供中文术语、中文模板或中国大陆网络可达性说明。
它能做什么 & 适用场景
Wiki Changelog 面向需要了解仓库近期开发活动的用户。它读取 Git 提交历史,检查提交日期、作者和消息,并按时间段与变更类型整理结果。技能会先确认源代码仓库上下文,再生成面向用户的简洁变更说明。若提供源仓库 URL,还会为提交哈希和文件引用生成链接。
先运行 git remote get-url origin 检查远程仓库;要求用户确认仓库是仅本地使用还是提供源仓库 URL;在上下文确定后读取 Git 日志中的提交、日期、作者和消息;将最近 7 天的提交按天分组,更早提交按周分组;把提交归类为功能、修复、重构、文档、配置、依赖或破坏性变更;合并相关提交,生成简洁的用户可读变更日志,并在有 REPO_URL 时链接提交哈希和变更文件。
- 维护者希望快速总结最近一周的代码变更并发布更新说明。
- 开发团队需要按功能、修复和重构类别整理一段时间内的提交。
- 新成员想通过近期提交了解仓库的开发活动。
- 项目负责人需要识别破坏性变更并查看对应的迁移提示。
优缺点一览
- 明确覆盖提交读取、时间分组、变更分类和用户向描述生成。
- 支持破坏性变更突出显示和迁移提示。
- 提供源仓库 URL 时可链接提交哈希和文件引用。
- MIT 许可,且属于持续开发中的 Microsoft Agent Skills 仓库。
- 必须先解决源仓库上下文,无法直接跳过确认流程。
- 来源未提供该单项技能的独立测试覆盖或支持平台列表。
- 输出质量依赖 Git 提交消息、日期和文件信息的可用性。
- 技能只处理 Git 历史变更,不负责代码评审或自动修改代码。
如何安装
在 Copilot CLI 中运行:/plugin marketplace add microsoft/skills,然后运行:/plugin install deep-wiki@skills。该技能位于 .github/plugins/deep-wiki/skills/wiki-changelog/SKILL.md。也可以运行 npx skills add microsoft/skills,在安装向导中选择所需技能;来源材料未说明如何在该向导中单独定位此插件内技能。
如何使用
使用“最近有什么变化?”、“生成变更日志”或“总结提交”等请求触发。技能开始生成日志前,会先检查 git remote get-url origin,并询问“这是一个仅本地的仓库,还是有源仓库 URL(例如 GitHub、Azure DevOps)?”在源仓库上下文确定前不会继续。