pr-commit-workflow

pr-commit-workflow 是一款专注于规范 Git 提交与 Pull Request 流程的 Agent Skill，旨在通过强制执行人工编写的结构化模板，提升代码审查的可读性与团队协作效率。该技能的核心用法围绕两大场景展开：针对纯提交任务，它遵循严格的提交信息格式规范，要求提供清晰的变更证据；针对 PR 创建或更新，它强制使用人工撰写的意图描述，杜绝 AI 生成或改写的内容，确保每个 PR 都包含真实的人类上下文。

该技能的显著优点在于建立了高信噪比的代码审查流程。通过引用 pr-human-template.md 等标准化模板，它确保 PR 描述结构统一、信息完整，特别适用于 Agent 辅助开发场景下保持人类主导权。build_pr_body.sh 脚本自动收集环境元数据（如 harness、model、terminal 等），为问题追溯提供上下文，同时遵循 POSIX 标准，具备良好的跨平台兼容性。此外，技能强调读取仓库特定的 AGENTS.md 或 PROCESS.md 文件，允许团队在不破坏全局规则的前提下进行本地化定制。

然而，该技能也存在一定局限性。首先，其来源为个人开发者账号（T3 可信度），长期维护稳定性存在不确定性，且采用 AGPL-3.0 许可证，对商业项目可能存在传染性限制。其次，技能高度依赖 GitHub CLI (gh) 和特定的文件结构，在非 GitHub 平台或自定义 Git 工作流中适用性受限。此外，强制要求人工撰写 PR 意图虽然提升了质量，但也增加了开发者的认知负担，对于快速迭代的小型项目可能显得过于繁重。

该技能最适合追求代码质量的中小型开发团队、采用 Agent 协作但需保持人类审查主导权的项目，以及需要严格合规审计的企业环境。对于使用 Git Flow 或 Trunk-Based Development 并强调 PR 审查文化的团队尤为适用。

使用风险方面，尽管安全评级达到 A 级，但仍需注意：脚本会读取并输出环境变量，虽无敏感信息收集设计，但用户应确保终端环境未泄露密钥；AGPL-3.0 许可证要求衍生作品开源，商业使用需谨慎评估合规性；作为 T3 来源项目，建议在生产环境部署前进行代码审计，并关注上游更新以获取安全补丁。

核心用法

pr-commit-workflow 是一款面向 AI Agent 的 Git 工作流规范化 Skill，通过结构化模板强制执行高信噪比的提交习惯。它包含两条主要路径：

1. Commit 工作流：遵循 references/workflow-commit.md 的清单式检查，要求每次提交附带意图说明与行为证据，采用 references/commit-format.md 的标准格式
2. PR 工作流：严格使用 references/pr-human-template.md 的人工编写模板，禁止 AI 生成或改写 PR 描述，通过 scripts/build_pr_body.sh 自动注入环境元数据

关键设计在于强制人类意图输入——系统会拒绝自动生成 PR 描述，要求用户明确提供变更目的。模板化结构使 PR 同时适配人类审查者和 AI Agent 的解析需求。

显著优点

• 审查友好：标准化格式降低认知负荷，支持跨团队协作
• 可追溯性：环境元数据（harness、model、terminal 等）自动归档
• 零依赖风险：纯 Markdown + Shell 实现，无第三方库
• AGPL-3.0 开源：代码完全透明，可审计可 fork

潜在局限

• 生态绑定：深度适配 GitHub CLI (gh)，GitLab/Bitbucket 支持有限
• 语言局限：模板为英语结构，国际化项目需自行扩展
• 来源信任：维护者 joshp123 为个人开发者（T3），长期维护存在不确定性
• 模板刚性：必须「verbatim」使用指定模板，高度定制化场景可能受限

适合人群

• 追求代码审查规范化的技术团队
• 需要 AI Agent 与人类协作的混合工作流场景
• 重视提交历史可读性的开源项目维护者

常规风险

• 低：无网络请求、无敏感数据收集、无危险系统调用
• 中：来源可信度 T3，建议关注上游更新动态