At a glance
What it does
Creates a conventional Git commit from staged changes and synchronizes configured HelloAGENTS state and project knowledge.
Before you choose it
Checks staged changes, generates or uses a conventional commit message, applies configured attribution, commits the staged snapshot, and conditionally updates workflow state and the knowledge base.
Best for
HelloAGENTS users ready to record reviewed changes in Git.
Common tasks
- Create a conventional commit
- Apply configured commit attribution
- Synchronize workflow state after committing
Permissions and data
The command reads staged changes and user settings, writes a Git commit, and may update local workflow state or project knowledge.
Permissions- Reads the staged Git diff
- Creates a local Git commit
- May update configured project knowledge
- Uses local commit attribution and knowledge-base settings
Limitations
- It stops when there are no staged changes
- The pinned document does not describe pushing or publishing the commit
What DSHub checked
- The pinned source and supplied artifact evidence were captured.
What DSHub did not check
- Installation and runtime behavior were not tested.
Pinned install
Primary action
This standalone skill does not have a DSH Plugin install action. Use its source documentation for the delivery method.
Maintainer source
Skill instructions
name: ~commit description: 规范化 Git 提交 + 知识库同步（~commit 命令） policy: allow_implicit_invocation: false
Trigger: ~commit [message]
执行 ~commit 时，知识库同步与状态文件更新范围按当前已加载的 HelloAGENTS“收尾与归档”/ 流程状态要求执行；本命令只负责生成提交信息、读取提交归属配置并完成提交动作。
auto_commit_enabled=false 只关闭收尾阶段的自动提交，不影响显式 ~commit。
流程
- 检查 staged changes（git diff --staged）
- 如果没有 staged changes，提示用户先 git add
- 生成 conventional commit message（如未提供）
- 格式: type(scope): description
- type: feat|fix|refactor|docs|test|chore|style|perf
- 先一次性解析会话中已知设置：优先使用当前会话上下文中已注入的“当前用户设置”、该配置文件原始 JSON 或此前读取结果摘要；上下文不存在或缺少
commit_attribution/kb_create_mode时，才读取一次~/.helloagents/helloagents.json - 复用上一步已解析的设置获取
commit_attribution：- ""（空，默认）→ 不添加归属
- 有内容（如 "Co-Authored-By: HelloAGENTS"）→ 添加该内容到 commit message
- 执行 git commit
- 若
state_path已存在，按 HelloAGENTS“已有则更新”要求同步当前已提交状态
知识库同步
提交后，继续复用上方已解析的同一份设置获取 kb_create_mode，不要再次读取 ~/.helloagents/helloagents.json：
- 0 = 跳过
- 1 = 知识库已存在时自动同步（默认）
- 2 = 编码任务在知识库已存在或当前项目已初始化时自动创建或同步 同步范围与更新格式按当前已加载的 HelloAGENTS“收尾与归档”阶段执行。
Operate deliberately
Install and manage
Prerequisites and target Profile
Target： No native DSH Profile target.
Delivery： Skill Files — https://github.com/hellowind777/helloagents。
Compatibility and access
Requires_host_review： Not established by supplied evidence。
Review compatibility evidence ↗
Risk facts
Review instructions before use.
Evidence ↗Evidence and editorial reviewManifest, Bundle patch, distribution and freshness
Immutable evidence
Review status and source activity
Approved for publication after reviewing the source-linked content and immutable release record. AI assisted with the draft; the publication decision was human.
Human reviewed Aug 30, 2026, 10:05 AM UTC。GitHub facts last checked Aug 30, 2026, 9:53 AM UTC。
No material source change has been recorded since this evidence baseline.