贡献者指南Council of High Intelligence的shellcheckdry-runchecklist三道测试关【免费下载链接】council-of-high-intelligenceStructured multi-perspective deliberation for hard decisions. Run full councils, focused triads, or duo debates across Claude Code, Codex, Gemini CLI, and OpenCode.项目地址: https://gitcode.com/GitHub_Trending/co/council-of-high-intelligenceCouncil of High Intelligence是一个面向高难度决策的结构化多视角审议插件可跨 Claude Code、Codex、Gemini CLI 和 OpenCode 运行完整委员会、快速小组或双人辩论。想为它写第一行代码本文带你走通贡献者必读的三道测试关shellcheck、--dry-run、以及那份覆盖协议一致性的模拟检查清单让你的 PR 一次就能合并。先克隆仓库熟悉贡献流程git clone https://gitcode.com/GitHub_Trending/co/council-of-high-intelligence cd council-of-high-intelligenceCONTRIBUTING.md 定义了标准开发流同步main分支创建功能分支git checkout -b feat/your-change修改后依次通过三道测试关用清晰的 commit message 提交向main发起 PR。三道关不是可选建议——它们全部跑在 CI 里本地过不了CI 也过不了。第一关shellcheck 静态检查安装脚本shellcheck install.sh这个仓库的核心交付物之一是多主机安装器 install.sh它会把技能文件写入~/.claude、~/.codex、~/.gemini、~/.config/opencode。凡是改动了安装逻辑就必须先过 shellcheck 提前暴露未加引号的变量、拼错参数名、危险的 glob 展开等问题CI 的 lint 工作流会对仓库跑 shellcheck markdownlint本地先跑一遍能省下排队等 CI 的时间注意检查清单脚本内部也会调用 shellcheck见 scripts/council-simulation-checklist.sh所以本地装上 shellcheck 是一石三鸟。 项目约定脚本中优先显式错误处理和清晰的用户可见输出这正好和 shellcheck 的告警方向一致。第二关--dry-run 预览写入不碰系统./install.sh --dry-run--dry-run让安装器只打印将要执行的动作不写任何文件install.sh。这是新手最安全的第一次完整安装演练命令验证目标./install.sh --dry-runClaude Code 默认安装路径./install.sh --dry-run --copy-configs额外复制 configs/ 路由模板./install.sh --dry-run --codexCodex 安装路径./install.sh --dry-run --geminiGemini 扩展清单gemini-extension.json检查清单并不只要求 dry-run能跑通它还逐条断言输出里出现了安装摘要Installed ... council agents、Installed ... config files、Installed Codex skill to等见 council-simulation-checklist.sh——也就是说用户看到的提示文案也是被测试覆盖的。按 CLAUDE.md 的约定改了 Codex 安装就跑--dry-run --codex改了 Gemini 就跑--dry-run --gemini。第三关checklist 模拟自检清单./scripts/council-simulation-checklist.sh这是三道关里最硬核的一道一份约 40 项的模拟自检任何一项[FAIL]都会以非零码退出并阻断合并[WARN]则放行但建议修复。它的覆盖面可以直接当成贡献者地图检查域代表检查项文件与插件清单SKILL.md、agents/ 下 18 份人格合约、插件 manifest 存在版本漂移CHANGELOG.md与plugin.json、marketplace.json版本号一致协议特性第二轮匿名化、反从众指令 ×3、Chairman 角色、判定三件套Acceptable Compromises / Kill Criteria / Concrete Next Step三文件一致性SKILL.md/SKILL.codex.md/SKILL.gemini.md必须同时包含STANCE:、Vote Tally、1.5× 加权席位与 2/3 共识阈值人格结构每份 agent 文件的章节顺序、provider_affinity与reasoning_method前置元数据自动路由scripts/detect-providers.sh 可执行且输出合法 JSON安装行为内嵌 shellcheck 四路 dry-run 输出断言一个值得记住的设计清单对 Gemini 镜像做了和 Codex 镜像完全对等的逐项检查——因为历史上功能漂移恰好发生过一次。这也是为什么改协议特性时规则要求你在两个宿主镜像中同步修改或书面说明豁免理由。协议改完后至少测一个模式静态检查之外CLAUDE.md 还要求协议改动后至少实际跑一个模式full / quick / duo。可以直接照抄演示会话 demos/session-pack.md 里的完整、快速、双人三类示例问题合并之后分支清理与风格约定分支清理来自 CONTRIBUTING.mdgit fetch origin --prune # 清理远端已合并的陈旧引用 git branch -d feat/your-change四条风格约定CONTRIBUTING.md文档与安装器行为保持同步脚本优先显式错误处理与清晰输出文件可动态发现时避免硬编码数量保持 demos/session-pack.md 与现役 profiles / triads 对齐。提交前自检清单shellcheck install.sh零告警改了安装逻辑时./install.sh --dry-run及对应--codex/--gemini通过改了对应安装时./scripts/council-simulation-checklist.sh全部 PASS协议改动已同步到SKILL.codex.md与SKILL.gemini.md至少实际运行了一个审议模式commit message 清晰、PR 目标分支为main把这三道关当成你每次改动的红绿灯本地全绿再提 PR合并才会又快又稳。【免费下载链接】council-of-high-intelligenceStructured multi-perspective deliberation for hard decisions. Run full councils, focused triads, or duo debates across Claude Code, Codex, Gemini CLI, and OpenCode.项目地址: https://gitcode.com/GitHub_Trending/co/council-of-high-intelligence创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考