pr-commit-workflow

📝 规范化Git提交与PR管理

🥥59总安装量 14评分人数 12
100% 的用户推荐

个人开发者开源方案,通过标准化模板与强制人工意图记录,建立高可审阅性Git工作流,提升代码审查效率。

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 代码安全规范,无 eval/exec/system 等危险函数,无可执行代码动态加载
  • ✅ 数据隐私保护良好,仅本地收集环境元数据(harness、model 等),无远程上传行为
  • ⚠️ 来源为个人开发者账号(T3 可信度),建议首次使用前审查脚本内容
  • ✅ 依赖可靠性高,仅使用 POSIX 标准 shell 内置命令,无外部网络依赖
  • ✅ 权限申请合理,与工作流指导功能匹配,无过度权限申请

使用说明

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.mdPROCESS.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 内容

文件夹图标references文件夹
文件夹图标scripts文件夹
手动下载zip · 6.5 kB
commit-format.mdtext/markdown
请选择文件