claudecode实战

your-project/
├── CLAUDE.md                     # 🤝 项目核心指令
├── CLAUDE.local.md               # 👤 个人项目指令 (不提交)
├── .mcp.json                     # 🔌 项目MCP服务器配置
└── .claude/
    ├── settings.json             # ⚙️ 共享配置
    ├── settings.local.json       # 👤 个人配置覆盖 (不提交)
    ├── agents/                   # 🤖 子代理
    │   └── *.md
    ├── commands/                 # ⌨️ 自定义斜杠命令
    │   └── *.md
    ├── skills/                   # 🎯 技能包
    │   └── */SKILL.md
    ├── rules/                    # 📜 按需加载的模块化规则
    │   ├── *.md
    │   └── path-spec/*.md
    └── hooks/                    # 🪝 钩子脚本
        └── *.sh, *.js, *.py

~/.claude/
├── CLAUDE.md                     # 🌐 全局核心指令
├── settings.json                 # ⚙️ 全局配置
├── credentials.json              # 🔑 认证凭据 (自动生成)
├── .claudesignature              # 🔒 内部签名 (自动生成)
├── agents/                       # 🤖 全局子代理
├── commands/                     # ⌨️ 全局命令 (/user:xxx)
├── skills/                       # 🎯 全局技能包
├── rules/                        # 📜 全局规则
├── hooks/                        # 🪝 全局钩子
├── plugins/                      # 🧩 已安装插件 (新增)
├── projects/                     # 📂 项目会话历史
├── cache/                        # 💾 缓存目录
├── ide/                          # 💻 IDE集成数据
├── statsig/                      # 📊 功能标志/实验配置
├── tempo/                        # ⏳ 会话临时数据
└── ... (其他如 debug/, file-history/, todos/ 等)

brainstorming          → 动手前先提炼需求，通过对话确认设计
using-git-worktrees    → 在新 Git 分支上创建隔离工作区
writing-plans          → 将设计拆成 2-5 分钟粒度的任务，每条任务有文件路径、完整代码和验证步骤
subagent-driven-development → 每个任务派发独立 subagent 执行，两阶段 review（规范合规 + 代码质量）
test-driven-development → 强制 RED-GREEN-REFACTOR：先写失败测试，再写最小实现，再提交
requesting-code-review → 任务间进行代码审查，严重问题阻断继续推进
finishing-a-development-branch → 验证测试后给出合并/PR/保留/丢弃选项

Think → Plan → Build → Review → Test → Ship → Reflect
/office-hours → /autoplan → (实现) → /review → /qa → /ship → /retro

Install gstack: run git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git .claude/skills/gstack && cd .claude/skills/gstack && ./setup

# 第一步：重塑需求（superpowers 自动触发 brainstorming）
You: 我想做一个日历每日简报 App

AI (superpowers brainstorming):
  你描述的是"简报 App"，但你实际要解决的是"会前准备太耗时"。
  我来挑战几个前提：
  1. 用户真正需要的是简报，还是"不被日历淹没"的感觉？
  2. 哪类事件最浪费你的准备时间？
  推荐：先做最窄的切入点，今天就能交付。
  [保存设计文档 → 自动传入下游 gstack 技能]

# 第二步：全套计划审查（gstack）
You: /autoplan
AI: 自动运行 CEO → 设计 → 工程审查...
  ✓ CEO Review: 建议聚焦"自动抓取会议室地址"作为 MVP
  ✓ Design Review: 信息密度评分 7/10，建议简化首屏
  ✓ Eng Review: 数据流图、边界情况、测试矩阵已生成

# 第三步：实现（superpowers 自动触发 subagent-driven-development）
You: 开始实现

AI (superpowers): 创建 Git worktree: feature/calendar-briefing
  Task 1.1: 实现 Google Calendar OAuth → subagent_1
  Task 1.2: 实现事件抓取与格式化 → subagent_2
  ...
  [两阶段 review 后全部通过]

# 第四步：QA 测试（gstack）
You: /qa https://staging.myapp.com
AI: 打开真实浏览器...
  ✓ 登录流程正常
  ✗ 发现 Bug：跨时区事件时间显示错误
  → 已生成 fix commit，回归测试通过

# 第五步：发布（gstack）
You: /ship
AI: Tests: 38 → 46 (+8 new)
  PR opened: github.com/you/app/pull/17

You: 生产环境偶发 500，复现不了

AI (superpowers systematic-debugging):
  阶段1：收集证据
  - 查看最近 error log：发现在高并发时触发
  - 检查数据库连接池配置

  阶段2：建立假设
  - 假设：连接池耗尽
  - 验证方案：在测试环境压测

  阶段3：测试假设
  [运行压测，复现问题]

  阶段4：修复与验证
  - 调整连接池 max_connections: 10 → 50
  - 证据：压测通过，500 消失
  [不声明完成，直到收集可验证证据]

You: /cso

AI (gstack CSO):
  运行 OWASP Top 10 + STRIDE 威胁建模...

  高置信度发现（≥8/10）：
  🔴 [A01-Broken Access Control] /api/admin 路由缺少权限校验
     Exploit: 任意未认证用户可访问管理接口
     修复：添加 requireAdmin 中间件

  🟡 [A03-Injection] 用户输入未经转义直接拼入 SQL
     Exploit: 构造 ' OR 1=1 -- 可绕过登录
     修复：使用参数化查询

  排除已知误报 17 项（低于 8/10 置信度未展示）

You: 我有 3 个独立模块需要同时开发

AI (superpowers dispatching-parallel-agents):
  分析模块依赖关系...无循环依赖，可并行。

  派发 3 个 subagent：
  → subagent_1: 用户模块 (预计 25 分钟)
  → subagent_2: 支付模块 (预计 40 分钟)
  → subagent_3: 通知模块 (预计 15 分钟)

  [并发执行，每个 subagent 独立 review]
  [全部完成后聚合结果，运行集成测试]

→ fluid not rigid         # 流动而非僵硬，随时可以修改计划
→ iterative not waterfall # 迭代而非瀑布，边做边完善
→ easy not complex        # 简单而非复杂，低仪式感
→ built for brownfield    # 既适合已有项目，也适合新项目
→ scalable                # 从个人项目到企业团队都适用

提案(proposal) → 规范(specs) → 设计(design) → 任务(tasks) → 实现(apply) → 归档(archive)

openspec/
├── specs/              # 系统当前行为的"真相来源"
│   └── <domain>/
│       └── spec.md
├── changes/            # 每个功能变更的独立文件夹
│   └── <change-name>/
│       ├── proposal.md  # 做什么、为什么做
│       ├── specs/       # 本次变更的增量规范（delta specs）
│       ├── design.md    # 技术方案
│       └── tasks.md     # 实现任务清单（带复选框）
└── config.yaml         # 项目配置（可选）

# 第一步：一键生成规划产物
You: /opsx:propose add-dark-mode

AI:  Created openspec/changes/add-dark-mode/
     ✓ proposal.md  —— 需求背景和范围
     ✓ specs/ui/spec.md  —— 增量需求规范
     ✓ design.md    —— 技术方案（CSS 变量 + React Context）
     ✓ tasks.md     —— 实现清单（8 条任务）
     Ready for implementation!

# 第二步：AI 按任务清单逐条实现
You: /opsx:apply

AI:  ✓ 1.1 Create ThemeContext with light/dark state
     ✓ 1.2 Add CSS custom properties to globals.css
     ✓ 1.3 Implement localStorage persistence
     ✓ 2.1 Create ThemeToggle component
     ...
     All 8 tasks complete!

# 第三步：归档，规范合并进主库
You: /opsx:archive

AI:  ✓ Merged specs → openspec/specs/ui/spec.md
     ✓ Archived to openspec/changes/archive/2025-01-24-add-dark-mode/

You: /opsx:explore

AI:  What would you like to explore?

You: 移动端 App 的认证方案应该用 JWT 还是 Session？

AI:  让我分析你的现有代码...
     你当前使用 Session 认证。移动端有三个选项：
     1. JWT（无状态，支持离线）
     2. OAuth2（适合第三方登录）
     3. 扩展现有 Session（简单但需要网络）

     推荐 JWT，与你的 CORS 配置兼容。需要创建变更吗？

You: 好，用 JWT。

AI:  运行 /opsx:propose add-jwt-auth 开始。

# 逐步创建产物，每步都可以人工审查和修改后再继续
You: /opsx:new add-payment-module

You: /opsx:continue
AI: ✓ Created proposal.md —— 请确认需求范围后继续

You: /opsx:continue
AI: ✓ Created specs/payment/spec.md —— 请确认接口约定

You: /opsx:continue
AI: ✓ Created design.md —— 请确认技术选型

You: /opsx:continue
AI: ✓ Created tasks.md —— 共 15 条任务

You: /opsx:apply

# 实现完成后验证规范一致性
You: /opsx:verify

AI:  ✓ Completeness: 15/15 tasks done
     ⚠ Warning: 缺少"支付超时"场景的测试覆盖
     Ready to archive (with warnings)

You: /opsx:archive

You: /opsx:bulk-archive

AI:  Found 3 completed changes:
     - add-dark-mode  (8/8 tasks)
     - fix-login-bug  (3/3 tasks)
     - update-footer  (2/2 tasks)

     ⚠ add-dark-mode 和 update-footer 都涉及 specs/ui/，将按时间顺序合并

     ✓ Archived add-dark-mode
     ✓ Archived fix-login-bug
     ✓ Archived update-footer