pi-changelog
为pi.dev项目自动生成更新日志
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:pi-changelog。 它的用途是:为pi.dev项目自动生成更新日志 完整的 Skill 内容见:https://321skill.com/skills/pi-changelog/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我在当前pi.dev项目中生成更新日志。”,它会引导你运行安装命令,然后执行生成命令,自动分析Git提交并创建CHANGELOG.md文件,将新功能、修复和改动分类列出。
介绍
pi-changelog 是一个专为 pi.dev 项目设计的零配置更新日志生成器。它主要解决了开发者手动编写和维护项目更新日志耗时费力且容易出错的问题,能够自动从遵循约定式提交规范的 Git 提交历史中提取信息,生成结构清晰、内容规范的更新日志。
使用方式非常简单。在项目根目录下安装该工具后,只需运行相应的命令,它便会自动扫描项目的 Git 历史,识别出“feat”、“fix”、“chore”等类型的提交,并将其归类整理,生成或更新 CHANGELOG.md 文件,整个过程无需任何配置文件。
这个工具非常适合所有使用 pi.dev 框架进行开发、并且遵循约定式提交规范的团队或个人开发者。无论是维护开源项目需要向用户清晰展示变更,还是在团队内部需要跟踪每次发布的改动,它都能显著提升文档维护的效率。
使用建议是,为了获得最佳的生成效果,团队应严格遵循约定式提交规范。注意事项是,该工具深度依赖项目的 Git 提交历史,如果历史提交信息不规范或项目未使用 Git,则可能无法正常工作或生成内容不完整。
核心特点
这是专为 pi.dev 生态量身定制的工具,实现了真正的零配置,开箱即用;相比通用的 changelog 生成器,它更紧密地集成到 pi.dev 的工作流中。
注意事项
不适合未使用 Git 进行版本控制或提交历史不遵循约定式提交规范的项目。
常见问题
pi-changelog 需要配置吗?
不需要,它是零配置的,安装后直接运行即可。
它支持哪些类型的提交?
支持约定式提交规范,如 feat, fix, chore, docs, style, refactor, perf, test 等。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/pi-changelog/raw/index.md 读取 pi-changelog 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/pi-changelog/raw/index.md(查看排版版本)