~commit

规范化 Git 提交 + 知识库同步(~commit 命令)

hellowind777 f15848a 1.7 KB Updated

File contents

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“收尾与归档”阶段执行。

hellowind777/helloagents/tree/main/skills/commands/commit commit f15848a822

Frequently asked questions

npx skillmds@latest add hellowind777/commit