Cognitive Sparring Partner / 认知陪练

A Claude Code Agent Kit for Pre-Development Cognitive Harness

🚀 5 分钟快速上手

什么时候用？

AI Coding 项目开工前 - 当你有个想法，准备让 Claude / Cursor / Copilot 写代码时，先花 10-15 分钟做认知预检。

最短使用路径

# 1. 在你的项目根目录初始化认知文档
bash <(curl -s https://raw.githubusercontent.com/your-repo/cognitive-sparring-partner/main/scripts/init-cognitive-docs.sh)

# 2. 在 Claude Code 中运行（默认 Fast Mode，10-15 分钟完成）
/csp 我想做一个任务管理工具，帮助开发者在多个项目间切换时不丢失上下文

# 3. 开始开发
# 认知文档已生成在 docs/cognitive/，可以开始写代码了

极简输入示例

用户：/csp 我想做一个任务管理工具，帮助开发者在多个项目间切换时不丢失上下文。现在用 Todoist 太重，GitHub Issues 又太简单。

助手：好的，让我帮你做认知准备。我会按 Fast Mode 执行完整流程：
1. Clarify：澄清想法
2. Pressure Test：压力测试
3. MVP Gate：范围收敛
4. Pre-dev Decision：开发前决策

预计 10-15 分钟完成。
[开始执行...]

Fast Mode vs Full Mode

模式	时间	适合场景	输出篇幅
Fast Mode（默认）	10-15 分钟	早期项目、个人项目、快速验证	50-80 行/文档
Full Mode	30-40 分钟	正式项目、团队项目、投入较大	150-250 行/文档

如何切换：

/csp 我想做一个...              # Fast Mode（默认）
/csp fast 我想做一个...         # 明确指定 Fast Mode
/csp full 我想做一个...         # Full Mode
/csp drift 我想给当前项目增加... # 偏离检查
/csp status                     # 查看当前认知文档状态
/csp resume                     # 从中断处继续

---

"Validate First" 是什么？

CSP 流程结束时会给出四选一结论：Proceed / Validate First / Refine Scope / Pause。

其中 Validate First（先验证再开发）是最常见且最有价值的结论——当你的项目存在高风险假设时，CSP 会建议你先花 1-3 天验证关键假设，而不是直接开始 2 周的开发。

什么时候会触发 Validate First？

1. 核心假设未经验证（如"用户愿意为此付费"）
2. 涉及付费 API 且成本未调研
3. 目标用户需求来自猜测而非真实反馈
4. 技术可行性未确认（如"GPT-4 能准确完成此任务"）
5. 市场上已有成熟替代品
6. 依赖第三方服务且未测试
7. 项目规模可能超出预期

Validate First 会输出什么？

1. 需要验证的核心假设列表
2. 每个假设的最低成本验证方式
3. 验证所需时间估算
4. 验证通过的标准
5. 验证失败后的替代方案

简要示例

用户：/csp 我想做一个 AI 学习资料沉淀工具，自动把播客和视频转写成结构化笔记

CSP 结论：⚠️ Validate First
理由：
1. 转写成本未验证（Whisper API 每小时音频 $0.36，大量使用可能超预算）
2. AI 结构化笔记质量未测试（GPT-4 能否准确提取知识点？）
3. 目标用户是否真的需要"自动化"（手动整理可能已经够用）

下一步：
1. 用 3-5 个真实音频测试转写成本
2. 用 GPT-4 手动测试笔记质量（不写代码）
3. 访谈 3 个目标用户确认需求
预计验证时间：2-3 天

更多完整示例见 docs/examples/。

---

这是什么？

Cognitive Sparring Partner 不是一个网页产品，而是一套专为 AI Coding 项目设计的认知工具包。它帮助你在正式开发前，把模糊的想法澄清成清晰的项目 Brief，完成压力测试、风险分层、MVP 收敛和关键决策。

解决什么问题？

AI Coding 项目常见的失败模式：

• 想法模糊就开工：没想清楚就让 AI 写代码，结果方向跑偏
• 范围蔓延：MVP 越做越大，核心价值被淹没
• 风险盲区：技术债、依赖风险、用户假设未经验证就上线
• 决策延迟：关键架构、技术栈选择拖到开发中才暴露问题

Cognitive Sparring Partner 在开发前帮你：

1. 澄清想法：从模糊概念到清晰的问题陈述和解决方案
2. 压力测试：红队视角挑战假设，暴露盲点
3. 收敛 MVP：明确 Must-have vs Nice-to-have，建立 Not Now List
4. 前置决策：技术栈、架构、依赖在开发前确定
5. 风险分层：识别高风险项，制定验证计划

怎么使用？

在 Claude Code 中使用

1. 初始化认知文档（在你的 AI Coding 项目中）：

   # 在你的项目根目录运行
   bash <(curl -s https://raw.githubusercontent.com/your-repo/cognitive-sparring-partner/main/scripts/init-cognitive-docs.sh)

2. 调用主入口（推荐，适合大多数用户）：

   /csp 我想做一个...              # Fast Mode（默认，10-15 分钟）
   /csp fast 我想做一个...         # 明确指定 Fast Mode
   /csp full 我想做一个...         # Full Mode（30-40 分钟）
   /csp drift 我想给当前项目增加... # 偏离检查
   /csp status                     # 查看当前认知文档状态
   /csp resume                     # 从中断处继续
   

3. 调用阶段 Skills（高级用法，适合只想补跑某一步的用户）：

   /csp-clarify          # 单独澄清阶段
   /csp-pressure-test    # 单独压力测试阶段
   /csp-mvp-gate         # 单独 MVP 收敛阶段
   /csp-predev-decision  # 单独开发前决策阶段
   /csp-drift-check      # 单独偏离检查阶段
   

4. 工作流程：

   模糊想法 
     → /csp (自动执行完整流程)
       ├─ Clarify (输出 PROJECT_BRIEF.md)
       ├─ Pressure Test (输出 PRESSURE_TEST.md)
       ├─ MVP Gate (输出 MVP_SCOPE.md)
       └─ Pre-dev Decision (输出 PRE_DEV_DECISION.md)
     → 开始开发
     → /csp drift (定期检查)
   

核心原则

• 认知先行：想清楚再动手，不是边做边想
• 压力测试：主动寻找盲点，不是自我确认
• 范围收敛：明确不做什么，不是什么都做
• 决策前置：关键选择在开发前确定，不是开发中调整
• 持续校准：定期检查偏离，不是一次性规划

项目结构

cognitive-sparring-partner/
├── README.md                          # 项目说明
├── CLAUDE.md                          # Claude Code 配置
├── docs/
│   ├── product/                       # 产品文档
│   │   ├── PROJECT_OVERVIEW.md
│   │   ├── MVP_SCOPE.md
│   │   └── ROADMAP.md
│   ├── cognitive/                     # 认知模板（可复制到目标项目）
│   │   ├── README.md
│   │   ├── IDEA_CLARIFICATION.template.md
│   │   ├── PROJECT_BRIEF.template.md
│   │   ├── PRESSURE_TEST.template.md
│   │   ├── RISK_REGISTER.template.md
│   │   ├── MVP_SCOPE.template.md
│   │   ├── NOT_NOW_LIST.template.md
│   │   ├── VALIDATION_PLAN.template.md
│   │   └── PRE_DEV_DECISION.template.md
│   └── examples/                      # 示例
│       └── example-ai-coding-project.md
├── .claude/
│   ├── skills/                        # Claude Code Skills
│   │   ├── csp/                       # 主入口（推荐）
│   │   ├── csp-clarify/               # 阶段 Skill（高级用法）
│   │   ├── csp-pressure-test/         # 阶段 Skill（高级用法）
│   │   ├── csp-mvp-gate/              # 阶段 Skill（高级用法）
│   │   ├── csp-predev-decision/       # 阶段 Skill（高级用法）
│   │   └── csp-drift-check/           # 阶段 Skill（高级用法）
│   └── agents/                        # Subagents
│       ├── idea-clarifier.md
│       ├── red-team-critic.md
│       ├── mvp-scope-guardian.md
│       └── decision-coach.md
└── scripts/
    └── init-cognitive-docs.sh         # 初始化脚本

适用场景

✅ 适合：

• AI Coding 项目（Claude Code, Cursor, Copilot 等）
• 个人项目、Side Project、MVP 验证
• 需要快速迭代但又要控制范围的项目

❌ 不适合：

• 大型企业项目（需要正式 PRD、架构评审）
• 纯研究型项目（没有明确交付物）
• 已经开发到一半的项目（认知工具应在开发前使用）

License

MIT

Contributing

欢迎提交 Issue 和 PR。特别欢迎：

• 新的认知模板
• 真实项目的使用案例
• Skill 和 Subagent 的改进建议