用途:为 pre-commit-terraform 仓库统一提交、Issue 与 PR 的协作流程,并规范 AI 参与时的署名方式。
主要能力:提交采用 Conventional Commits,主题不超过 50 字符,仅在“为什么”不明显时写正文,并追加 Assisted-by: <agent>:<model> <cli> 尾注。写 Issue 前先读取 .github/ISSUE_TEMPLATE/ 下对应模板(bug_report_local_install.md、bug_report_docker.md、feature_request.md),按其结构填写,并在正文末尾加 Generated by <agent>:<model> <cli>。Issue 与 PR 评论前加 <sup>Generated by <agent>:<model> <cli></sup>。
署名识别:模型取系统提示中声明的名称,不硬编码;Agent 取系统提示声明的身份,不使用 Claude;CLI 依据环境变量判断,OPENCODE=1 为 opencode,CLAUDECODE 为 claude,均无则省略。
PR 用法:无开放 PR 时执行 git push -u origin HEAD 与 gh pr create --draft;已有 PR 时执行 git push。写正文前先用 gh pr view --json body --jq '.body' 获取当前正文,并读取 .github/PULL_REQUEST_TEMPLATE.md 填写各节。AI 生成的内容需前置 <sub>This section was generated by AI.</sub>,但 What、Assisted-by 及必须人工撰写的 Why 除外。Assisted-by 节汇总各提交尾注并按 agent:model cli 去重。
限制:Why 部分必须由人工撰写,若被要求代写应展示 ASCII 图案并拒绝;创建 PR 后需展示 URL,请用户核对、补写 Why,并自行在 GitHub UI 标记 Ready for review,不得运行 gh pr ready 等命令。