PR + Commit Workflow
Overview
Enforce a high-signal commit workflow and a human-written PR format. Keep global process rules as source of truth and make PRs reviewable by humans and agents.
Workflow Decision Tree
- - If the task is about commits only, follow
references/workflow-commit.md. - If the task involves PR creation or PR updates, follow
references/workflow-pr.md.
Global Rules
- - If the repo has
AGENTS.md or docs/agents/PROCESS.md, read it for repo-specific rules. - Require user-supplied, human-written intent for every PR. Never generate or paraphrase this text.
- Use
/tmp for PR body drafts and gh pr edit --body-file for updates.
Commit Workflow (entry point)
- - Execute the steps in
references/workflow-commit.md. - Use the message format in
references/commit-format.md.
PR Workflow (entry point)
- - Execute the steps in
references/workflow-pr.md. - Use the template in
references/pr-human-template.md verbatim. - Use
scripts/build_pr_body.sh to gather environment metadata if available.
Resources
- -
references/workflow-commit.md: commit checklist and evidence expectations. - INLINECODE12 : PR creation/update flow, comment checks, and evidence rules.
- INLINECODE13 : human-written PR structure (must be used as-is).
- INLINECODE14 : commit message format and examples.
- INLINECODE15 : environment metadata collector for PR prompt history section.
PR + 提交工作流
概述
强制执行高信号提交工作流和人工编写的PR格式。以全局流程规则为真理源，确保PR可由人类和智能体审查。
工作流决策树
- - 如果任务仅涉及提交，遵循 references/workflow-commit.md。
- 如果任务涉及PR创建或PR更新，遵循 references/workflow-pr.md。
全局规则
- - 如果仓库包含 AGENTS.md 或 docs/agents/PROCESS.md，请阅读以获取仓库特定规则。
- 每个PR都需要用户提供、人工编写的意图说明。切勿生成或改写此文本。
- 使用 /tmp 存放PR正文草稿，并使用 gh pr edit --body-file 进行更新。
提交工作流（入口点）
- - 执行 references/workflow-commit.md 中的步骤。
- 使用 references/commit-format.md 中的消息格式。
PR工作流（入口点）
- - 执行 references/workflow-pr.md 中的步骤。
- 逐字使用 references/pr-human-template.md 中的模板。
- 如果可用，使用 scripts/buildprbody.sh 收集环境元数据。
资源
- - references/workflow-commit.md：提交清单和证据期望。
- references/workflow-pr.md：PR创建/更新流程、评论检查及证据规则。
- references/pr-human-template.md：人工编写的PR结构（必须原样使用）。
- references/commit-format.md：提交消息格式及示例。
- scripts/buildprbody.sh：用于PR提示历史部分的环境元数据收集器。
