# 提交 ## 第 1 步：需要提交配置检查 `.agents/commit.config.yml` 是否存在。 * 如果存在则继续步骤2 * 如果没有，按照 `references/config-setup.md` 创建它，然后继续 ## 第 2 步：收集背景信息分别运行每个命令： 1. `git diff --staged` 2. 仅当步骤 1 没有输出时：`git diff` 3. `git log --oneline` ## 步骤 3：确定分期 * 如果 `git diff --staged` 有输出 -> 按原样使用（用户手动策划） * 如果为空 -> 运行 `git add -A` 来暂存所有内容 ## 步骤 4：同步文档 1.从`.agents/commit.config.yml`读取`文件` 2. 查找不在配置中的可能是文档的暂存`*.md`文件（不包括`skills/`），检测其更新情况，注册它们 3.对于每个跟踪的文件，评估分阶段更改是否满足“update_when” 4. 读取并更新每个满足条件的文件 5. 如果在步骤 2 中注册了新文件，请保留更新的配置 ## 步骤 5：阶段文档 git add <更新的文档文件> ## 第6步：生成并执行提交 **主题：** 语义提交格式（`feat:`、`fix:`、`refactor:`、`docs:`、`chore:`、`test:`、`ci:`、`perf:`、`style:`、`build:`）。小写命令式，无句点，最多 70 个字符。使用范围可以增加清晰度。 **正文：**解释**原因**——动机、权衡、决定。明确地破坏状态变化。 **参考文献：** 问题/票据参考文献在其自己的行上（例如“Closes #142”）。使用 HEREDOC 执行： git commit -m "$(cat <<'EOF' feat：描述更改内容的主题行正文解释了为何进行此更改。关闭#issue（如果适用） EOF ）” ## 第 7 步：推送 git Push -u 原点 HEAD ## 步骤 8：拉取请求仅当在步骤 7 中推送分支时。 1. 运行 `gitbranch` — 如果在 `main` 上，则停止 2. 生成 PR 标题和正文： git log <基础分支>..HEAD --oneline git diff <基础分支>...HEAD 3. 创建公关： gh pr create --title "<标题>" --body "$(cat <<'EOF' ## 总结 <提交分析的要点> ## 测试计划 <清单> EOF ）” ## 验收清单 * 提交配置存在于 `.agents/commit.config.yml` * 文档与分阶段更改同步 * 提交消息遵循带有正文的语义格式 * 更改推送到远程 * 创建 PR（如果不在主页面）

犯罪

包含技能