commit

name: commit description: 规范化 Git 提交 + 知识库同步（commit 命令） policy: allow_implicit_invocation: false

Trigger: ~commit [message]

执行 ~commit 时，知识库同步与状态文件更新范围按当前已加载的 HelloAGENTS“收尾与归档”/ 流程状态要求执行；本命令只负责生成提交信息、读取提交归属配置并完成提交动作。 auto_commit_enabled=false 只关闭收尾阶段的自动提交，不影响显式 ~commit。

流程

1. 检查 staged changes（git diff --staged）
2. 如果没有 staged changes，提示用户先 git add
3. 生成 conventional commit message（如未提供）
   • 格式: type(scope): description
   • type: feat|fix|refactor|docs|test|chore|style|perf
4. 先一次性解析会话中已知设置：优先使用当前会话上下文中已注入的“当前用户设置”、该配置文件原始 JSON 或此前读取结果摘要；上下文不存在或缺少 commit_attribution / kb_create_mode 时，才读取一次 ~/.helloagents/helloagents.json
5. 复用上一步已解析的设置获取 commit_attribution：
   • ""（空，默认）→ 不添加归属
   • 有内容（如 "Co-Authored-By: HelloAGENTS"）→ 添加该内容到 commit message
6. 执行 git commit
7. 若 state_path 已存在，按 HelloAGENTS“已有则更新”要求同步当前已提交状态

知识库同步

提交后，继续复用上方已解析的同一份设置获取 kb_create_mode，不要再次读取 ~/.helloagents/helloagents.json：

• 0 = 跳过
• 1 = 知识库已存在时自动同步（默认）
• 2 = 编码任务在知识库已存在或当前项目已初始化时自动创建或同步 同步范围与更新格式按当前已加载的 HelloAGENTS“收尾与归档”阶段执行。