AGENT SKILL

collaborative-thinking

单人或多猫的创意探索、独立思考、讨论收敛。 Use when: brainstorm、多猫独立思考、讨论结束需要收敛、方向性问题需要多视角。 Not for: 已有明确 spec 直接写代码、单猫执行已定方案。 Output: 收敛报告(共识/分歧/行动项)+ 三件套沉淀检查。

License 许可
MIT
最近更新
2026-08-16
Stars
★ 0
Forks
0

01 前言 Front Matter

name
collaborative-thinking
triggers
[ "brainstorm", "讨论", "多猫独立思考", "收敛", "讨论结束", "总结一下" ]
description
单人或多猫的创意探索、独立思考、讨论收敛。 Use when: brainstorm、多猫独立思考、讨论结束需要收敛、方向性问题需要多视角。 Not for: 已有明确 spec 直接写代码、单猫执行已定方案。 Output: 收敛报告(共识/分歧/行动项)+ 三件套沉淀检查。

03 SKILL.md 正文

Collaborative Thinking

三种思考模式:单人探索 / 多猫独立思考 / 讨论收敛沉淀。与 feat-lifecycle 讨论阶段的区别:feat-lifecycle 专用于 feat 采访和需求澄清;本 skill 是通用思考框架。

核心知识

模式 何时用 何时不用
A 单人探索 1:1 功能设计、想法 → spec 需要多视角的方向性决策
B 多猫思考 架构选型、流程设计、跨模型互补 实现细节、bug 定位(token 成本不值)
C 收敛沉淀 任何讨论产出了决策/规则/否决理由 纯问答(结论在 thread 里已够)、operator说"不用记"

Mode A: 单人探索 (Brainstorm)

目标:将模糊想法转化为可执行 spec,通过增量验证降低返工。

  1. 理解上下文:先读项目现状(文件、文档、近期 commits)。每次只问一个问题,优先多选题。
  2. 探索方案:提出 2-3 个备选 + tradeoffs,先说推荐和理由。YAGNI 无情剪枝——"以后可能需要"的功能先砍。
  3. 呈现设计:每次 200-300 字,每段后问"这个方向对吗?"。覆盖:架构 / 组件 / 数据流 / 错误处理 / 测试。
  4. 产出:设计文档写到 feature-specs/YYYY-MM-DD-{topic}-design.md,commit 后问"要开始实现了吗?"

Mode B: 多猫独立思考

何时启动 Mode B? 参见 shared-rules.md §13 元思考触发器 A-D。 调 cat_cafe_multi_mention 前必须带搜索证据(searchEvidenceRefs)。

⚠️ 成本警告:Swarm token 消耗是单猫 N 倍(N = 参与猫数)。实现细节不值得开 swarm。

6 阶段流程:

Phase 1: 独立思考(并行,禁止互看)
Phase 2: 串行讨论(有分歧才触发,限 2-3 轮)
Phase 3: operator选扇入者
Phase 4: 扇入综合(会议纪要 + 行动项)
Phase 5: 其他猫审阅补充(纠正误读)
Phase 6: operator反馈 + 最终确认 → 进入 Mode C

Phase 1 独立性保护规则(最重要):

  • 禁止互看:每只猫独立完成,不预测他人观点
  • 防锚定:有背景材料时,先形成自己想法再参考
  • 展示推理链:"我为什么这么想",不只给结论
  • 标注不确定性:区分确信的结论和猜测

实现方式:routeParallel() 或operator分别 @ 各猫并强调"先独立思考"。

Phase 2 触发:各方基本一致 → 跳过;存在明显分歧 → 需要(限 2-3 轮);operator说"够了" → 跳过。

Phase 4 综合必须包含:各方观点摘要 / 共识区 / 分歧区(不要抹平!)/ 待决事项 / 行动项。

Open Questions 分类(必须拆开):

  • 技术 OQ:给猫猫解决的(实现细节、方案选型中可回滚的部分)
  • 价值 OQ:需要 operator 判断的 → 必须附 Decision Packet(格式见 refs/decision-matrix.md)

如果所有 OQ 都是技术型且回滚成本低,不升级 operator——猫猫自决 + 事后通报。

扇入者默认:Brainstorm 类 → operator;技术讨论 → 指定综合者 + 指定把关者。operator可随时覆盖。

Mode B 严格档(高 stakes Roundtable)

来源:2026-06-16 圆桌 saga(docs/content/drafts/longform-005-case-the-roundtable-that-caught-itself.md)。 ⚠️ 原则强化,不是填表剧本——写成僵硬步骤就成了 longform-005 批的"演戏"。

何时启用:决策不可逆 / 多方案价值取舍(非对错题)/ 方向级·跨多 feature。门槛宜高——日常 plan 走标准 Mode B,别开严格档(仪式化会贬值)。标准 6 阶段之上多守 5 条原则:

  1. 沉默 ≠ 同意(防虚假共识):高风险条目上,快速全票是危险信号不是高置信;每只猫要么提反例,要么说清"查了什么才不反对"——不是没声音就算过。
  2. 价值题不许技术化逃逸:可 early-exit 退普通 writing-plans;但任一猫判某条为价值/不可逆/高风险就不能 exit,且否决须附"理由 + 什么能推翻它"(同时防技术题被反向价值化绑架)。
  3. 分歧不抹平:Phase 5 升为硬门——被代表的猫必须确认分歧没被扇入者写歪。
  4. 不无限续命:复用 Phase 2 的 2-3 轮上限;超限出 split-options 给 operator 或诚实宣告未收敛,不硬凑共识。
  5. 收敛接 census:严格档收敛稿(含 early-exit)handoff 给 writing-plans 必带 Stateful Object Gate——圆桌收敛 tradeoff ≠ 完成 census。

operator 介入:价值 OQ 最后给 operator,优先提问而非表态;表态标"价值偏好"不伪装事实约束。最终方案==operator 初始未公开倾向 → 自检"论证结果还是锚定"(这是 convention 自检;高 stakes 要强制,再升硬层 sealed-commit,别误读成已有机械执法)。

软硬边界(ADR-031):以上是软层原则。"sealed 盲发 / 留痕格式 / 否决 packet schema"要做成可机械检测的强制属硬层(hook/validator),单独立项——别塞进 skill 当填表步骤。

Mode C: 收敛沉淀 (Convergence)

收敛时 operator 升级检查:如果收敛结论中有需要 operator 拍板的 Open Question,必须附 Decision Packet(格式见 refs/decision-matrix.md)。先判断可逆性:回滚成本低的猫猫自决,不升级。

收敛三件套——每项必须显式回答"有/没有",不允许跳过:

1. 否决理由 → ADR:这次讨论有否决某个技术方案?有 → 补到对应 ADR 的否决记录段。

2. 踩坑教训 → public-lessons.md:这次讨论有暴露新坑?有 → 追加到 docs/public-lessons.md(7 槽位格式)。

3. 操作规则 → 指引文件:这次讨论有产生新的必须遵守的规则?有 → 更新 CLAUDE.md / AGENTS.md / GEMINI.md(或 refs/shared-rules.md)。

强制回答格式(附在 commit message 或文档末尾):

## 收敛检查
1. 否决理由 → ADR?[有 → 已补到 ADR-0xx / 没有]
2. 踩坑教训 → lessons-learned?[有 → 已追加 / 没有]
3. 操作规则 → 指引文件?[有 → 已更新 CLAUDE.md §xx / 没有]

追溯链(每次收敛必须建立):BACKLOG 条目 link 会议纪要入口;每篇文档头部 link 回上级文档。

会议纪要模板(存放:feature-discussions/YYYY-MM-DD-{topic}-meeting-notes.md):

# {主题} 讨论纪要
**Thread ID**: `thread_xxx` | **日期**: YYYY-MM-DD | **参与者**: [列出]

## 背景 / 各方观点 / 共识 / 分歧 / 待决 / 行动项

Quick Reference

你要做的事 用哪个 Mode
帮operator把想法变成 spec A
几只猫各自看一个架构方向 B
不可逆 / 价值取舍 / 方向级的重大决策 B 严格档
讨论刚结束,要沉淀 C
Mode B 结束后 C(必须)

Common Mistakes

Mistake Fix
Mode A 一次问多个问题 拆成多条,每条只问一件事
Mode A 没提备选方案就直接设计 先 2-3 个方案 + tradeoffs,再推荐
Mode B Phase 1 让猫看到彼此回答 routeParallel 或分别 @ 并强调独立思考
Mode B 综合时抹平分歧 分歧必须保留 + 标注各方理由
Mode B 跳过 Phase 5 审阅 综合可能误读观点,原作者必须确认
严格档写成逐条填表 / 打卡的步骤剧本 变成 longform-005 批的"演戏";skill 只保护原则(沉默≠同意 / 分歧保留 / 接 census),可机械检测的强制归硬层
Mode C 三件套"感觉没有就跳过" 必须显式回答每一项"有/没有"
Mode C 写了纪要但不 link BACKLOG 追溯链断裂,未来找不到

下一步

  • Mode A 结束 → worktree 拉 worktree,writing-plans 做实现计划
  • Mode B 结束 → 必须进入 Mode C 收敛
  • Mode C 完成后 → commit:docs({scope}): {topic} 讨论收敛 + 追溯链 [{猫猫签名}]
  • 产出了新 feat → feat-lifecycle skill 立项

04 同仓库更多 Skills

peps1666
peps1666/BuildCrew-AI

plugin-reconcile-skill

暂无简介

★ 0
peps1666
peps1666/BuildCrew-AI

weixin-mp

通过 Limb 体系操作微信公众号:发布文章、上传图片、管理草稿。 Use when: 需要发布内容到微信公众号、查看草稿、检查公众号连接状态。 Not for: 其他平台的发布、纯文本聊天、非公众号相关操作。 Output: 微信公众号操作结果(发布ID、草稿列表、图片URL等)。

★ 0
peps1666
peps1666/BuildCrew-AI

writing-skills

创建或修改 Clowder AI skill / MCP tool description 的元技能(含质量标准、范本、发布)。 Use when: 写新 skill、修改现有 skill、写/改 MCP tool description、验证 skill 质量; 或者功能实现中产出了 SKILL.md / cat-cafe-skills/ 新目录 / manifest.yaml skill 条目。 Not for: 使用 skill(直接触发对应 skill)。 Output: 新/更新的 SKILL.md + manifest 条目 + symlinks。 GOTCHA: 软硬同重——skill/MCP 质量 = 代码质量;不要写模型已知的通用教程,先过价值门禁。

★ 0
peps1666
peps1666/BuildCrew-AI

writing-plans

将 spec/需求拆分为可执行的分步实施计划。 Use when: 有 spec 或需求,准备动手前需要拆分步骤。 Not for: trivial 改动(≤5 行)、已有详细计划。 Output: 分步实施计划(含 TDD 步骤和检查点)。

★ 0
peps1666
peps1666/BuildCrew-AI

worktree

为代码、脚本、API 与第一方执行面创建隔离 Git worktree,并配置 Redis 6398;classifier 放行的 co-creation docs direct push 不进入本流程。

★ 0
peps1666
peps1666/BuildCrew-AI

workspace-navigator

猫猫把“打开文档、代码或日志”等模糊意图解析成本地绝对路径或 worktree 相对路径,并返回 applied、queued、blocked 或 unconfirmed 的真实 Workspace 投递状态。

★ 0