Example Titles

feat(auth): 添加 JWT 登录流程
fix(ui): 修复侧边栏空指针问题
refactor(api): 拆分用户控制器逻辑
docs(readme): 添加使用说明章节

Example with Title and Body

feat(auth): 添加 JWT 登录流程

- 实现了 JWT 令牌验证逻辑
- 为验证组件添加了文档说明

Rules

• title is lowercase, no period at the end.
• Title should be a clear summary, max 50 Chinese characters.
• Use the body (optional) to explain why, not just what.
• Bullet points should be concise and high-level.

Avoid

• Vague titles like: "update", "fix stuff"
• Overly long or unfocused titles
• Excessive detail in bullet points

Allowed Types

有附加要求时，在模板后追加：

用户附加要求

<附加要求原文>

### 提交轮提示词（`prompts/commit.md` → `COMMIT_PROMPT`）

用户已选择提交。请先运行 git status（或 git diff --staged --stat）判断是否已有暂存改动:

• 若无已暂存改动: 执行 git add -A（若我在上文附加要求中指定了提交范围, 则按该范围 add）后再提交;
• 若已有暂存改动: 不要再 add, 直接对已暂存内容提交。 用你上面生成的 commit message 执行 git commit; sandbox 环境用多个 -m（首个为标题, 其余为正文）, 不要加任何广告尾注。

### 非交互提交技能正文（`prompts/skill-commit.md` → `GIT_COMMIT_SKILL`）

Task

把当前 git 工作区的改动提交为一条中文 commit message。这是非交互执行: 直接按下方规则生成推荐消息并提交, 不要向用户确认提交信息, 也不要等待用户选择。

Steps

1. 先运行只读 git 命令了解当前状态, 不要臆测:
   • git status —— 查看工作区与暂存区状态
   • git diff --staged —— 查看已暂存的改动（若没有暂存改动, 可再看 git diff 了解未暂存改动）
   • git branch --show-current —— 当前分支
   • git log --oneline -10 —— 近期提交风格参考
2. 生成一条中文 commit message, 遵守下方 Format / Rules / Allowed Types。
3. 直接提交, 不询问用户:
   • 若无已暂存改动: 执行 git add -A（若任务中指定了提交范围, 按该范围 add）后再提交;
   • 若已有已暂存改动: 不要再 add, 直接对已暂存内容提交。
   • 用生成的 message 执行 git commit; sandbox 环境用多个 -m（首个为标题, 其余为正文）, 不要加任何广告尾注。

Format

<type>:<space><message title in Chinese>

<bullet points in Chinese summarizing what was updated>

Example Titles

feat(auth): 添加 JWT 登录流程
fix(ui): 修复侧边栏空指针问题
refactor(api): 拆分用户控制器逻辑
docs(readme): 添加使用说明章节

Example with Title and Body

feat(auth): 添加 JWT 登录流程

- 实现了 JWT 令牌验证逻辑
- 为验证组件添加了文档说明

Rules

• title is lowercase, no period at the end.
• Title should be a clear summary, max 50 Chinese characters.
• Use the body (optional) to explain why, not just what.
• Bullet points should be concise and high-level.

Avoid

• Vague titles like: "update", "fix stuff"
• Overly long or unfocused titles
• Excessive detail in bullet points

Allowed Types

## Behavior

- 阶段状态机（`idle` / `generate` / `commit`）按会话 id 保存在**进程内**：`generate` 回合结束后弹三选；
  `commit` 回合结束后仅复位；`idle` 不干预普通对话。同一生成回合只弹一次三选（防抖）。
- 对话框被取消、agent 已失效、或部署无 `userQuestions` provider 时，流程安全回到 `idle`，不做任何提交。
- 插件消息以 `form: 'notice'` 形态写入转录（单行摘要），完整提示词作为消息正文。
- `git-commit-zh` 技能仅在宿主挂载 `skills` 服务时注册（`ctx.inject`），对模型与用户均开放
  （`modelInvocable: true, userInvocable: true`）；技能正文来自 `prompts/skill-commit.md`。

## Known Limitations and Deferred Work

- **阶段状态不跨进程持久化**：DSH 主机插件与进程同生命周期，阶段存于内存；完整重启后复位为
  `idle`。若在生成回合与三选之间重启，重跑一次 `/gen-commit-msg-zh` 即可。
- **交互菜单需要 UI 部署**：`userQuestions` 为可选服务，无 provider 时命令只触发生成轮、不弹菜单。
- **技能需要 `skills` 服务**：宿主未挂载 `dsh-skill` 时 `git-commit-zh` 不注册（命令不受影响）。
- **依赖模型与 bash 工具**：提交由模型执行，需要部署允许 bash 且具备 git 写权限。
- 未迁移 Pi 版的 `ctx.ui.notify` 通知（DSH 无对等 API）；进度通过命令结果文本与转录呈现。