feat(git): 新增提交信息生成 Skill
This commit is contained in:
@@ -14,7 +14,7 @@ CraftKit 是一组面向 Codex 插件市场的中性 Skill 工具。项目从通
|
|||||||
| --- | --- | --- |
|
| --- | --- | --- |
|
||||||
| `dev` | 软件设计、编码、审查与测试 | 已初始化,暂无 Skill |
|
| `dev` | 软件设计、编码、审查与测试 | 已初始化,暂无 Skill |
|
||||||
| `doc` | 文档转换、整理与写作 | 已迁移 `format-md`、`docx-to-md` |
|
| `doc` | 文档转换、整理与写作 | 已迁移 `format-md`、`docx-to-md` |
|
||||||
| `git` | 分支、提交、变更提取与集成 | 已初始化,暂无 Skill |
|
| `git` | 分支、提交、变更提取与集成 | 已迁移 `commit-msg` |
|
||||||
| `knowledge` | 交接、复盘、经验与工作总结 | 已初始化,暂无 Skill |
|
| `knowledge` | 交接、复盘、经验与工作总结 | 已初始化,暂无 Skill |
|
||||||
| `skill` | Skill 创建、迁移、检查与同步 | 已初始化,暂无 Skill |
|
| `skill` | Skill 创建、迁移、检查与同步 | 已初始化,暂无 Skill |
|
||||||
|
|
||||||
|
|||||||
@@ -55,7 +55,7 @@
|
|||||||
|
|
||||||
1. `doc/format-md`:纯指令型样本,已完成。
|
1. `doc/format-md`:纯指令型样本,已完成。
|
||||||
2. `doc/docx-to-md`:多来源合并、脚本、依赖和生成物样本,已完成。
|
2. `doc/docx-to-md`:多来源合并、脚本、依赖和生成物样本,已完成。
|
||||||
3. `git/commit-msg`:只读 Git 状态分析样本。
|
3. `git/commit-msg`:只读 Git 状态分析样本,已完成。
|
||||||
4. `git/branch`:修改仓库状态和二次授权边界样本。
|
4. `git/branch`:修改仓库状态和二次授权边界样本。
|
||||||
5. `knowledge/handoff`:模板化文档与项目上下文样本。
|
5. `knowledge/handoff`:模板化文档与项目上下文样本。
|
||||||
6. `skill/guidance`:大型参考资料、索引和渐进式加载样本。
|
6. `skill/guidance`:大型参考资料、索引和渐进式加载样本。
|
||||||
@@ -226,5 +226,6 @@ plan-change
|
|||||||
- [x] 实现迁移台账预览和更新脚本。
|
- [x] 实现迁移台账预览和更新脚本。
|
||||||
- [x] 迁移并验证首个样板 `doc/format-md`。
|
- [x] 迁移并验证首个样板 `doc/format-md`。
|
||||||
- [x] 迁移并验证脚本型特殊样本 `doc/docx-to-md`。
|
- [x] 迁移并验证脚本型特殊样本 `doc/docx-to-md`。
|
||||||
|
- [x] 迁移并验证只读 Git 特殊样本 `git/commit-msg`。
|
||||||
- [ ] 完成其余特殊样本并总结批量迁移规则。
|
- [ ] 完成其余特殊样本并总结批量迁移规则。
|
||||||
- [ ] 按插件和风险类型推进同质批量迁移。
|
- [ ] 按插件和风险类型推进同质批量迁移。
|
||||||
|
|||||||
@@ -219,7 +219,10 @@
|
|||||||
"source-b:2a64acb63e8b2030": {
|
"source-b:2a64acb63e8b2030": {
|
||||||
"sourcePathHash": "2a64acb63e8b203031c4ef292f957c0fe0d3722e079dc9a299730015b9e3359c",
|
"sourcePathHash": "2a64acb63e8b203031c4ef292f957c0fe0d3722e079dc9a299730015b9e3359c",
|
||||||
"sourceSha256": "580da97b2fb16543db9aef62359f153fe5aca382d88987f10f233289bc02790d",
|
"sourceSha256": "580da97b2fb16543db9aef62359f153fe5aca382d88987f10f233289bc02790d",
|
||||||
"status": "pending"
|
"status": "migrated",
|
||||||
|
"target": "plugins/git/skills/commit-msg",
|
||||||
|
"targetVersion": "0.1.0",
|
||||||
|
"reviewedAt": "2026-08-25"
|
||||||
},
|
},
|
||||||
"source-b:3a5d583c511959b3": {
|
"source-b:3a5d583c511959b3": {
|
||||||
"sourcePathHash": "3a5d583c511959b3d1934d15eaa9b0cd0590c558535b6a8307f870d7ce0c8dd0",
|
"sourcePathHash": "3a5d583c511959b3d1934d15eaa9b0cd0590c558535b6a8307f870d7ce0c8dd0",
|
||||||
|
|||||||
@@ -1 +0,0 @@
|
|||||||
|
|
||||||
@@ -0,0 +1,36 @@
|
|||||||
|
---
|
||||||
|
name: commit-msg
|
||||||
|
description: 分析当前 Git 工作区或暂存区的真实变更,生成一个或多个 Conventional Commit 提交信息及对应文件范围。适用于提交前整理信息;暂存、提交、推送或修改仓库不应由本 Skill 执行。
|
||||||
|
---
|
||||||
|
|
||||||
|
# 生成提交信息
|
||||||
|
|
||||||
|
只读检查 Git 变更,给出可复核的 Conventional Commit 建议。不得执行 `git add`、`git commit`、`git push` 或其他会改变仓库状态的命令。
|
||||||
|
|
||||||
|
## 收集变更
|
||||||
|
|
||||||
|
1. 运行 `git status --short --branch` 确认仓库、分支以及 staged、unstaged、untracked 状态。
|
||||||
|
2. 分别运行 `git diff --cached --name-status` 和 `git diff --name-status`,不要把两类变更混为同一范围。
|
||||||
|
3. 先根据文件名识别敏感路径,例如 `.env`、凭据、令牌、私钥和本地配置。对这些路径只报告风险,不读取或回显差异内容。
|
||||||
|
4. 对其余相关路径分别读取 staged 或 unstaged diff。差异很大时先看 `--stat`,再按逻辑模块分段检查。
|
||||||
|
5. 未跟踪文件默认不纳入建议范围;只有用户明确要求评估时,才读取已确认且不敏感的文件。
|
||||||
|
|
||||||
|
## 形成建议
|
||||||
|
|
||||||
|
- 依据变更意图选择 `feat`、`fix`、`refactor`、`docs`、`test`、`build`、`ci`、`chore`、`perf`、`style` 或 `revert`。
|
||||||
|
- `scope` 只有在能从模块或职责明确判断时才使用;不能确定时省略,不从来源目录机械截取。
|
||||||
|
- 描述应简洁说明本组变更实现的结果,使用用户或仓库约定的语言。
|
||||||
|
- 互相依赖、共同完成一个目的的文件可归为一组;目的、模块或风险不同的变更应建议拆分。
|
||||||
|
- staged 与 unstaged 都存在时,明确标注每条建议基于哪一种状态。
|
||||||
|
- 不把敏感文件、未确认的未跟踪文件或明显无关的改动列入建议范围。
|
||||||
|
|
||||||
|
## 输出格式
|
||||||
|
|
||||||
|
对每个逻辑分组给出:
|
||||||
|
|
||||||
|
1. 建议提交信息:`<type>(<scope>): <description>`,无明确 scope 时省略括号。
|
||||||
|
2. 建议范围:列出对应文件,并注明 staged 或 unstaged。
|
||||||
|
3. 排除项:列出未纳入的未跟踪、敏感或无关文件。
|
||||||
|
4. 风险提示:说明混合状态、潜在凭据、二进制文件或尚未检查的内容。
|
||||||
|
|
||||||
|
若没有变更,直接说明无需生成提交信息。若证据不足以判断意图,先说明缺口并请求用户补充,不根据文件名编造业务目的。
|
||||||
@@ -0,0 +1,4 @@
|
|||||||
|
interface:
|
||||||
|
display_name: "Commit Message"
|
||||||
|
short_description: "只读分析 Git 变更并生成可复核的提交信息"
|
||||||
|
default_prompt: "使用 $commit-msg 分析当前 Git 变更并建议提交信息,不要暂存或提交。"
|
||||||
Reference in New Issue
Block a user