用途:当活跃仓库为 Gentleman-Programming/gentle-ai 且贡献者不是维护者时使用,涵盖开 issue、评论、起草与审计 PR 正文、选择链式 PR 策略、用 GitHub API 交叉核对 PR 声明、判断某操作属贡献者范围还是维护者范围。不适用于把 gentle-ai 当安装器使用、阅读文档、调试测试、通用代码审查或其他仓库任务。
主要规则:issue-first 是强制的,没有已获 status:approved 的 issue 不得开 PR,由 pr-check.yml 与 CONTRIBUTING.md 约束。是否在合并时关闭 issue(Closes/Fixes/Resolves #N 或 Refs #N)须询问人类,不得自行推断或更改。每 PR 新增加删除上限 400 行,超出需 size:exception 并附理由与人类选择。提交不得带 Co-Authored-By 尾注。禁止强推 main。PR 正文复选框必须与 API 状态一致;若标签为空,不勾选“已加 type:*”,改为记录待办。标题须符合约定式格式且仅一个 scope。
权限边界:贡献者可开/评论 issue、开 PR、编辑自己的 PR 正文、推送自有分支;普通与 type:* 标签操作仅在规范 issue 创建工作流契约下进行;status:approved、size:exception 属受保护标签,需当前直接人类指令且操作者具 MAINTAIN/ADMIN;审批 fork 工作流、审查 PR、合并 PR、向上游推 slice/* 分支仅维护者可为。缺少指令或能力时等待,不做变更。
用法:先读 CONTRIBUTING.md、PR 模板、issue 模板、pr-check.yml、相关 skills 文件;每个贡献开始前重读。本地验证命令包括 go build ./...、go vet ./...、go test ./internal/...。PR 创建前用仓模板起草正文,创建需单独授权。链式策略有 Stacked to main 与 Feature Branch Chain 两种;GitHub 不支持跨 fork base ref,只有维护者能把 slice 分支推到上游。
验证:授权后使用 $TARGET,用 gh pr view 与 gh issue view 核对标签、关联 issue 与计数;已存在失败必须用同一命令与环境在隔离干净基线上复现,否则标注基线未验证。资料未提供安装命令、收费信息或效果数据。