关于 skill-council
skill-council 通过 Claude Octopus 命令行运行 council 式流程,协调独立建议、交叉评议与综合结论。流程包含法定人数、预算检查和实施审批关卡。
主要功能
- 01由运行器驱动的 council 流程
- 02独立建议与交叉评议
- 03主持人综合并保留分歧
- 04法定人数与预算检查
- 05实施审批关卡
适用场景
- 01比较多个角色给出的建议
- 02制定实施计划前审查风险
- 03运行先研究后评议的流程
- 04保留异议与未完成结果
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ nyldn/ claude-octopus --skill skill-council安装后在 Claude Code 中输入/skill-council确认已加载。
附带文件agents/openai.yaml
详细介绍
Council
将此技能用于 /octo:council 和 Council 风格的请求。
执行契约:强制要求
/octo:council 是由运行器驱动的工作流。默认情况下,执行真实的 shell 运行器:
"${CLAUDE_PLUGIN_ROOT:-$HOME/.claude-octopus/plugin}/scripts/orchestrate.sh" council <user arguments>
沙盒安全调用(Claude Code 沙盒中必需)。 orchestrate.sh
必须是命令的第一个词元。沙盒的非沙盒命令允许列表使用前缀锚定匹配,因此,以
cd …、内联 VAR=… 环境变量赋值或任何其他前缀开头的命令都无法匹配 …/orchestrate.sh *
条目——运行器随后会在沙盒中执行,其 codex/agy 席位子进程将无法写入临时文件(Operation not permitted,agy 在 /var/folders 中执行 mkstemp 时失败),因此 Council 会放弃运行器,回退到直接使用单个提供方进行分发。若要针对工作树运行,请传入 --dir <path>(运行器已支持 -d/--dir),不要用 cd <path> && … 包装命令;在单独的前置步骤中设置环境变量,或使用前置的 env VAR=… /abs/path/orchestrate.sh council …,以确保可解析的二进制路径仍位于首位。切勿在运行器前加上 cd。
不要模拟 Council、在当前模型中扮演所有成员,也不要直接代替运行器作答。只有在明确请求使用 --simulate 或 --single-model 时,才可进行单模型模拟;使用时,须将输出标记为 single-model simulation,并确保生成的 summary.json 路径清晰可见。否则,缺少提供方法定人数意味着 Council 仅部分完成或失败,并不代表可以悄悄降级。
阶段 0A:交互式澄清
如果用户调用 /octo:council 时任务含糊、缺少目标或深度意图、实现授权不明确,或研究/语料库要求不清楚,请先使用 AskUserQuestion,再运行 Council 运行器。如果提示中已包含明确标志和清晰任务,则跳过此阶段并立即执行。
默认的 Council 澄清问题:
AskUserQuestion({
questions: [
{
question: "How should the council handle this request?",
header: "Council Goal",
multiSelect: false,
options: [
{label: "Advice (Recommended)", description: "Return a structured recommendation without implementation"},
{label: "Decision", description: "Optimize for choosing between specific options"},
{label: "Implementation plan", description: "Produce a plan but do not edit files"},
{label: "Review", description: "Critique existing code, docs, or strategy"}
]
},
{
question: "How deep should the council go?",
header: "Depth",
multiSelect: false,
options: [
{label: "Standard (Recommended)", description: "Balanced cost and coverage"},
{label: "Quick", description: "Faster, lower-cost pass"},
{label: "Deep", description: "More critique and revision, higher cost"}
]
},
{
question: "Should the council use project research or corpus storage?",
header: "Context",
multiSelect: false,
options: [
{label: "No corpus (Recommended)", description: "Run with the provided prompt and write normal run artifacts"},
{label: "Research first", description: "Add --research-first before provider fanout"},
{label: "Append corpus", description: "Use --corpus-mode append for durable project notes"},
{label: "Require corpus", description: "Use --corpus-mode require and stop if no corpus workspace exists"}
]
}
]
})
按以下方式转换答案:
- 建议、决策、实施计划或审查 ->
--goal advice|decision|plan|review - 快速、标准或深入 ->
--depth quick|standard|deep - 优先研究 ->
--research-first - 追加语料库或要求语料库 ->
--corpus-mode append|require
阶段 0:预检
收集或推断以下信息:
- 目标:
advice、decision、plan、implement或review - 领域:
auto、architecture、product、security、business、research或docs - 风格:
balanced、adversarial、implementation、executive或red-team - 深度:
quick、standard或deep - 成员数:
auto、3、5或7 - 预算上限(USD)
- 提供方及其可用性
- 固定角色设定
- 实现授权和工作树隔离
- 研究是否必须在 Council 扇出前进行(
--research-first) - 是否必须将发现、研究、综合结果和计划追加到项目语料库(
--corpus-mode append|require)
在向提供方扇出请求之前,展示所选 Council、提供方可用性、基准数据新鲜度、法定人数要求和成本估算。在批评、修订、综合和实施规划之前重新检查预算,确保运行会在下一阶段可能超出 --max-cost 前停止。如果是试运行,则在此预检后停止并写入 summary.json。
如果设置了 --research-first,先收集本地语料库证据,再在允许的情况下收集当前外部来源。在向提供方扇出请求之前,将简明的发现保存为运行产物。如果设置了 --corpus-mode append 或 --corpus-mode require,在宣告完成前,必须按照项目持久语料库的约定追加研究笔记、发现、综合结果和实施计划;如果没有可用的语料库工作区,require 必须停止运行。
Quorum
- quick 需要至少一条非主席回复,以及一位具备综合能力的主席
- standard 和 deep 需要至少两条非主席回复,以及一位具备综合能力的主席
- 如果主席失败,则使用得分最高且具备综合能力的候补者重试一次
- 如果失去法定人数,默认停止并呈现部分产物,而不是假装达成了共识
Council Procedure
- **独立建议:**请每位选定的人格提供建议、假设、风险、实施说明和信心度。
- **交叉评议:**对于 standard/deep 运行,对回复进行半匿名处理,并请成员评议其中的缺漏、假设和风险。
- **修订:**对于 deep 运行或存在重大分歧的情况,允许成员在评议后修订立场。
- **主席综合:**给出共识、分歧、少数意见报告、风险登记表、实施路径、信心度,以及可能改变建议的条件。
- **批准 / 否决:**验证、安全对抗、安全、法律、财务和医疗角色可因重大风险否决实施。
Implementation Gates
- **Gate A:**用户接受理事会综合意见或要求修订。
- **Gate B:**用户接受根据综合意见生成的具体实施计划。
- **Gate C:**执行遵循现有的 Octopus 实施安全机制。这是对已接受计划的一次性授权,而非逐文件审批,除非现有安全钩子检测到破坏性或高风险操作。
未经明确批准,绝不根据理事会输出进行实施。在最终答复和产物中保留分歧、总结风险,并明确呈现否决意见。
Interactive Choice Handling
当用户需要澄清范围、选择深度 / 提供方 / 语料库选项、批准关卡或决定后续操作时,使用 AskUserQuestion 并提供 2-4 个互斥选项。将推荐选项放在首位。不要以开放式问题或一组问题结尾;应呈现选项交互并等待答复。