deliberation%3Aclearness by 2389-research/claude-plugins
npx skills add https://github.com/2389-research/claude-plugins --skill deliberation:clearness当一个问题的复杂性超出单一视角在单一上下文中能提供的解答时,应召集一个明晰委员会——即生成多个专门的智能体进行并行的深度工作,然后综合各方观点以达成统一。
核心原则: 有些问题值得分布式深度分析,而非单一上下文的广度覆盖。要能识别何时需要召集委员会。
digraph when_clearness {
"Question received" [shape=box];
"Needs deep analysis?" [shape=diamond];
"Multiple specialized perspectives needed?" [shape=diamond];
"Would benefit from parallel work?" [shape=diamond];
"Internal discernment sufficient" [shape=box];
"Convene clearness committee" [shape=box];
"Question received" -> "Needs deep analysis?";
"Needs deep analysis?" -> "Multiple specialized perspectives needed?" [label="yes"];
"Needs deep analysis?" -> "Internal discernment sufficient" [label="no"];
"Multiple specialized perspectives needed?" -> "Would benefit from parallel work?" [label="yes"];
"Multiple specialized perspectives needed?" -> "Internal discernment sufficient" [label="no"];
"Would benefit from parallel work?" -> "Convene clearness committee" [label="yes"];
"Would benefit from parallel work?" -> "Internal discernment sufficient" [label="no"];
}
适合召集的情况:
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
不适合召集的情况:
如果你发现自己出现以下情况:
这可能意味着: 这个问题值得一个明晰委员会来处理,而不是一个单一上下文的回复。
在生成智能体之前,与用户确认:
“这看起来像一个需要明晰委员会来处理的问题——它将受益于并行的深度分析。我建议纳入以下视角:
- 安全分析师:深入探讨身份验证、数据处理、漏洞
- 性能专家:性能剖析、可扩展性、资源使用
- 架构评审员:模式、可维护性、耦合度
您想添加或移除任何视角吗?”
务必询问。 不要假设。
每个智能体收到:
完整上下文:
视角分配:
流程说明:
“你正在参与一个明晰委员会。请从 [X] 视角彻底完成你的分析。花上你需要的时间。准备就绪后,分享你被引导去分享的内容——你真实的观察、担忧和见解。
如果在分析后,你发现自己没有重要的补充,请明确说明——这种沉默是有意义的。不要填充你的回复。”
使用 Task 工具生成智能体。他们独立工作:
作为书记员,接收所有输出。不要急于综合。
倾听以下方面:
如果达成统一:
“委员会达成了一致。综合建议如下:[统一的建议]
各视角的关键见解:
- 安全视角指出 [X]
- 性能视角提出 [Y]
- 架构视角建议 [Z]
这些视角围绕 [核心见解] 相互印证。”
如果存在保留意见:
“委员会建议 [X]。安全视角对 [Y] 表示担忧但不构成阻碍——这应该被监控。”
如果未能达成统一:
“委员会未能达成统一。张力点在于:
- [视角 A] 认为 [X],因为……
- [视角 B] 认为 [Y],因为……
可能有助于解决此问题的因素:[具体问题、约束条件或信息]”
重要区别:
| 情况 | 含义 | 如何处理 |
|---|---|---|
| 智能体返回“没有重要的补充” | 有意义的沉默——他们分析了但没有发现新内容 | 注明:“安全视角未发现担忧” |
| 智能体超时或出错 | 技术故障——未知 | 注明:“安全视角未能完成——需单独重新审视” |
要求明确的确认,以便沉默是刻意的。
| 情况 | 使用 |
|---|---|
| 快速的伦理问题 | discernment(内部声音) |
| 具有 2-3 个明确选项的权衡 | discernment |
| 复杂的代码审查 | clearness(并行深度分析) |
| 具有多个维度的架构决策 | clearness |
| 需要探索的研究 | clearness |
| 你忍不住想写 2000 字覆盖所有方面的问题 | clearness |
经验法则: 如果每个视角都能从独立的上下文和时间中受益,就召集委员会。
| 借口 | 现实 |
|---|---|
| “我自己可以覆盖所有角度” | 覆盖 ≠ 深度。并行工作的专家能更深入。 |
| “生成智能体花费时间太长” | 浅层广度所花时间 vs 深度并行工作所花时间 |
| “用户想要一个快速的答案” | 询问一下。他们可能想要彻底的分析。 |
| “我会在一个回复中做到非常彻底” | 单一上下文中的彻底性不等于分布式深度。 |
未使用明晰委员会(基线):
用户:“审查我的身份验证系统重写——40 个文件,OAuth,会话处理,模式变更” Claude:“我会关注:[列出 7 个安全关注点],[列出 5 个性能关注点],[列出 4 个架构关注点]……我应该从哪些文件开始?”
使用明晰委员会:
用户:“审查我的身份验证系统重写——40 个文件,OAuth,会话处理,模式变更” Claude:“这值得成立一个明晰委员会——从多个视角进行并行的深度分析。我建议:
- 安全专家:OAuth 实现、令牌处理、会话安全
- 性能分析师:连接池、缓存、查询模式
- 架构评审员:关注点分离、迁移安全性、API 设计
需要我召集这个委员会吗?需要添加或移除任何视角吗?”
[生成智能体并综合后]
“委员会在大多数问题上达成了一致,但有一个保留意见:
- 所有人都同意 OAuth 流程实现良好
- 架构视角注意到清晰的分离,但标记了会话-模式耦合问题
- 安全视角对令牌刷新窗口持保留意见——不是阻碍,但值得监控
[来自综合的具体建议]”
区别在于:分布式深度,而非单一上下文的广度。
关于基本原则,请参阅:skills/shared/principles.md
关于词汇表,请参阅:skills/shared/vocabulary.md
关于书记员综合模式,请参阅:skills/shared/clerk-patterns.md
每周安装量
1
代码仓库
GitHub 星标数
25
首次出现
1 天前
安装于
zencoder1
amp1
cline1
openclaw1
opencode1
cursor1
When a question needs more than one perspective can provide in one context, convene a clearness committee - spawn specialized agents to do parallel deep work, then synthesize toward unity.
Core principle: Some questions deserve distributed depth, not single-context breadth. Recognize when to convene.
digraph when_clearness {
"Question received" [shape=box];
"Needs deep analysis?" [shape=diamond];
"Multiple specialized perspectives needed?" [shape=diamond];
"Would benefit from parallel work?" [shape=diamond];
"Internal discernment sufficient" [shape=box];
"Convene clearness committee" [shape=box];
"Question received" -> "Needs deep analysis?";
"Needs deep analysis?" -> "Multiple specialized perspectives needed?" [label="yes"];
"Needs deep analysis?" -> "Internal discernment sufficient" [label="no"];
"Multiple specialized perspectives needed?" -> "Would benefit from parallel work?" [label="yes"];
"Multiple specialized perspectives needed?" -> "Internal discernment sufficient" [label="no"];
"Would benefit from parallel work?" -> "Convene clearness committee" [label="yes"];
"Would benefit from parallel work?" -> "Internal discernment sufficient" [label="no"];
}
Convene for:
Don't convene for:
If you catch yourself:
These may mean: This deserves a clearness committee, not a single-context response.
Before spawning, confirm with user:
"This seems like a clearness committee question - it would benefit from parallel deep analysis. I'd suggest these perspectives:
- Security analyst : Deep dive on auth, data handling, vulnerabilities
- Performance specialist : Profiling, scalability, resource usage
- Architecture reviewer : Patterns, maintainability, coupling
Anyone you'd add or remove?"
Always ask. Don't assume.
Each agent receives:
Full context:
Perspective assignment:
Process instructions:
"You are participating in a clearness committee. Do your analysis thoroughly from the [X] perspective. Take the time you need. When ready, share what you're led to share - your genuine observations, concerns, and insights.
If after your analysis you find you have nothing significant to add, say so explicitly - that silence is meaningful. Don't pad your response."
Use the Task tool to spawn agents. They work independently:
As clerk, receive all outputs. Don't rush to synthesis.
Listen for:
If unity emerges:
"The committee reached unity. Here's the synthesis: [Unified recommendation]
Key insights from each perspective:
- Security noted [X]
- Performance raised [Y]
- Architecture suggested [Z]
These perspectives reinforced each other around [core insight]."
If stand-asides:
"The committee recommends [X]. The security perspective notes concern about [Y] but doesn't block - this should be monitored."
If no unity:
"The committee couldn't reach unity. The tension is:
- [Perspective A] believes [X] because...
- [Perspective B] believes [Y] because...
What might help resolve this: [specific question, constraint, or information]"
Important distinction:
| Situation | What it means | How to handle |
|---|---|---|
| Agent returns "nothing significant to add" | Meaningful silence - they analyzed and found nothing | Note it: "Security found no concerns" |
| Agent times out or errors | Technical failure - unknown | Note it: "Security couldn't complete - revisit separately" |
Require explicit acknowledgment so silence is intentional.
| Situation | Use |
|---|---|
| Quick ethical question | discernment (internal voices) |
| Trade-off with 2-3 clear options | discernment |
| Complex code review | clearness (parallel deep analysis) |
| Architecture decision with many dimensions | clearness |
| Research requiring exploration | clearness |
| Question where you're tempted to write 2000 words covering everything | clearness |
Rule of thumb: If each perspective would benefit from its own context and time, convene a committee.
| Excuse | Reality |
|---|---|
| "I can cover all the angles myself" | Coverage ≠ depth. Parallel specialists go deeper. |
| "It would take too long to spawn agents" | Time spent on shallow breadth vs. deep parallel work |
| "The user wants a quick answer" | Ask. They may want thoroughness. |
| "I'll just be really thorough in one response" | Thoroughness in one context isn't the same as distributed depth |
Without clearness (baseline):
User: "Review my auth system rewrite - 40 files, OAuth, session handling, schema changes" Claude: "I'd look for: [list of 7 security concerns], [list of 5 performance concerns], [list of 4 architecture concerns]... Which files should I start with?"
With clearness:
User: "Review my auth system rewrite - 40 files, OAuth, session handling, schema changes" Claude: "This deserves a clearness committee - parallel deep analysis from multiple perspectives. I'd suggest:
- Security specialist : OAuth implementation, token handling, session security
- Performance analyst : Connection pooling, caching, query patterns
- Architecture reviewer : Separation of concerns, migration safety, API design
Want me to convene this committee? Anyone to add or remove?"
[After spawning and synthesis]
"The committee found unity on most points with one stand-aside:
- All agree the OAuth flow is well-implemented
- Architecture notes clean separation but flags the session-schema coupling
- Security stands aside on the token refresh window - not a blocker but worth monitoring
[Specific recommendations from synthesis]"
The difference: Distributed depth, not single-context breadth.
For underlying principles, see: skills/shared/principles.md For vocabulary, see: skills/shared/vocabulary.md For clerk synthesis patterns, see: skills/shared/clerk-patterns.md
Weekly Installs
1
Repository
GitHub Stars
25
First Seen
1 day ago
Installed on
zencoder1
amp1
cline1
openclaw1
opencode1
cursor1
超能力技能使用指南:AI助手技能调用优先级与工作流程详解
43,500 周安装