用途:为仓库提供提交信息格式与提交工作流规范,适用于创建 Git 提交、审阅已暂存改动或生成符合约定式提交(Conventional Commits)风格的提交信息。主要能力:定义提交信息结构,包含标题行、Summary、New Components、Enhanced Components、Files Changed 等部分;规定类型前缀 feat(新功能)、fix(缺陷修复)、refactor(重构,不改变行为)、chore(依赖、配置、工具)、docs(仅文档),scope 为可选项,用于标明具体领域,如 feat(citations):、fix(auth):。使用方式:遵循提交工作流,1. 运行 git diff --staged 审阅全部暂存改动;2. 必要时读取文件获取上下文,查找相关 issue 编号;3. 将提交信息写入 COMMIT_MESSAGE.md;4. 运行 git commit -F COMMIT_MESSAGE.md;5. 删除 COMMIT_MESSAGE.md。规则要求:标题行不超过 72 字符并使用祈使语气(如 Add 而非 Added);适用时在 Summary 中包含 Fixes #N 或 Closes #N;Files Changed 段落必须列出全部改动文件;省略 Testing 与 Breaking Changes 段落(该仓库不使用);新组件用要点描述关键特性,增强组件说明改了什么及原因;提交正文最后一行始终包含 Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com。限制:不要执行 git add 暂存文件(由调用方负责);不要执行 git push(由用户决定何时推送);不要修改代码,提交工作流中仅创建提交。
committing-code
编程与开发
更新于 10-16 00:30