mcpField
D
dialectic

dialectic

github.com/umputunAgent 工作流49061 次安装3 天前更新
代码仓库

关于 dialectic

dialectic 是一种分析技能,通过两个并行 Agent 分别寻找支持和反对证据来评估观点。随后综合双方发现,并对照代码实现进行核验。

主要功能

  1. 01并行分析正反观点
  2. 02提供文件路径和行号证据
  3. 03综合相反方向的发现
  4. 04对照实现进行核验
  5. 05适用于架构、故障和代码评审

适用场景

  1. 01评估架构决策
  2. 02分析修复问题的主张
  3. 03核查性能相关说法
  4. 04评审代码变更

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/umputun/cc-thingz --skill dialectic

安装后在 Claude Code 中输入/dialectic确认已加载。

详细介绍

辩证分析

通过并行运行两个目标相反的 Agent,然后综合分析结果,对陈述进行客观分析。

流程

步骤 1:并行启动 Agent

**关键:两次 Task 工具调用必须在同一条消息中发出,才能真正并行执行。**不要使用 run_in_background。不要按顺序启动。在同一条消息中启动的前台 Agent 会并行运行,并在两者都完成后才返回。

Agent 1(正题)——寻找所有正面证据:

  • 表现良好的方面、改进之处、正确的模式
  • 支持事实、证明陈述为真的证据
  • 优势、长处、成功结果

Agent 2(反题)——寻找所有负面证据:

  • 存在问题的方面、问题、风险、反模式
  • 边缘情况、证明陈述为假的证据
  • 弱点、失败模式、隐藏成本

分析代码时,两个 Agent 都必须提供具体的文件路径和行号。

步骤 2:综合分析

两个 Agent 完成后,将发现综合为客观结论:

  • 权衡双方的证据
  • 找出正题与反题一致之处(最有力的信号)
  • 指出尚未解决的矛盾
步骤 3:验证

关键——给出综合分析后,需根据实际实现进行验证:

  • 阅读两个 Agent 提及的具体文件和行号
  • 确认所引用的证据确实存在于代码库中
  • 检查实现流程是否符合所述结论
  • 验证综合分析是否准确反映实际代码上下文
  • 找出 Agent 报告中的误解或遗漏的上下文
  • 如果验证发现不准确之处,则修订综合分析

使用场景

架构决策:

/thinking-tools:dialectic this microservice split improves maintainability

Bug 分析:

/thinking-tools:dialectic the connection pool fixes the timeout issue

性能声明:

/thinking-tools:dialectic caching reduced database load by 80%

重构安全性:

/thinking-tools:dialectic extracting this interface simplifies testing

代码审查:

/thinking-tools:dialectic this implementation is thread-safe

审查变更:

/thinking-tools:dialectic review the changes in server.go

核心原则

  • 消除确认偏误——同时审视正反两面,避免锚定于第一个结论
  • 以证据为依据——Agent 必须引用具体文件、行号和事实,而非泛泛而谈
  • 必须验证——展示前必须根据实际代码检查综合结论
  • 客观结论——目标是寻求真相,而非让任何一方获胜

评论

支持 Markdown