用途:为向用户不拥有的公开上游 GitHub 仓库贡献代码提供本地优先、带门禁检查的工作流。仅适用于外部仓库,jeremylongshore/* 与 intent-solutions-io/* 视为范围外。
主要能力:以本地文本保存持久状态,候选文件位于 ~/.contribute-system/candidates/OWNER__REPO__issueNUMBER.md,仓库档案位于 ~/.contribute-system/research/OWNER__REPO.md,追加式事件日志位于 ~/.contribute-system/log.jsonl;GitHub 为实时 issue 与 PR 状态的权威来源。支持仓库接入、状态对账、候选发现与评分、资格核验、认领草拟、开发验证与提交准备。
使用方式:需 gh 已认证、PATH 中有 jq,运行状态位于 ~/.contribute-system/,上游克隆位于 ~/000-projects/contributing-clanker/。先运行 gh auth status,不得请求、打印、存储或命令行传递令牌。常用命令包括 ${CLAUDE_SKILL_DIR}/scripts/dashboard.sh、transition.sh shortlist→claimed CANDIDATE_FILE、transition.sh working→submitted CANDIDATE_FILE、doctor.sh。资格核验示例:gh pr list --repo OWNER/REPO --search "ISSUE_NUMBER" --state=all。
适用场景:查询 PR 状态、寻找可贡献任务、认领指定 issue、提交修复。
限制:不得自主发布评论或创建 PR,须等待人工批准;不得伪造端到端测试结果;不得强制推送;档案缺失或超过 14 天需先构建或刷新;门禁阻断须报告 ID 与证据,覆盖需用户明确指示并记录原因;测试需完整栈而不可得时只能做诚实的隔离检查或拒绝。