手机上直接让AI写代码?这个开源神器把Claude Code接入了企业微信

手机上直接让 AI 写代码?这个开源神器把 Claude Code 接入了企业微信!

你有没有想过这样一个场景——

下班路上,地铁里刷着手机,突然想到一个 Bug 的解决方案。掏出电脑?不存在的。打开企业微信,给 Claude Code 发条消息:「帮我把 src/auth.py 的登录逻辑修一下」,几秒钟后,代码改好了,测试通过了,你安心继续刷视频。

这不是做梦。一个叫 cc-connect 的开源项目,真的把这件事干成了。

它到底干了什么?

一句话说清楚:cc-connect 是一个 AI Agent 桥接器,把本地的 AI 编程助手接到你常用的聊天平台上。

什么意思?看这张图就懂了:

你(企业微信/飞书/Telegram/...)
        ↕
   cc-connect(本地中转)
        ↕
  Claude Code / Cursor / Gemini(本地 Agent)

你在聊天软件里发消息 → cc-connect 转给本地的 AI Agent → Agent 干完活 → 结果回到你的聊天窗口。

手机、平板、任何设备,只要有聊天软件就能用。

支持哪些平台和 Agent?

先说聊天平台,主流的几乎全覆盖:

  • 企业微信、飞书、钉钉
  • Telegram、Discord、Slack、LINE
  • 个人微信(通过 ilink)
  • 微博私信、QQ、WPS 协作

再说 AI Agent,主流编程助手都能接:

  • Claude Code(Anthropic)
  • Codex(OpenAI)
  • Gemini CLI(Google)
  • Cursor Agent、iFlow、OpenCode、Devin CLI、Kimi CLI

基本上,你用什么聊天工具,它就能接到哪儿;你用什么 AI 编程助手,它就能桥接谁。

怎么装?三步搞定

第一步:装 cc-connect

npm install -g cc-connect

对,就这么一行命令。没装 Node.js 的先去装一下。

第二步:装你的 AI Agent

比如用 Claude Code:

npm install -g @anthropic-ai/claude-code

第三步:配置

推荐用 Web UI 配置,可视化的,不用手写配置文件:

cc-connect web

浏览器自动打开管理面板,点点鼠标就配好了。

以企业微信 + Claude Code 为例

这是国内开发者最关心的组合,我详细说一下。

1. 创建企业微信机器人

登录企业微信管理后台 → 应用管理 → 自建 → 创建应用。记下 Bot ID 和 Bot Secret。

2. 写配置文件

编辑 ~/.cc-connect/config.toml:

language = "zh"

[log]
level = "info"

[[projects]]
name = "my-coder"

[projects.agent]
type = "claudecode"

[projects.agent.options]
work_dir = "/你的项目目录"
mode = "auto"

[projects.agent.env]
ANTHROPIC_AUTH_TOKEN = "你的API Key"
ANTHROPIC_BASE_URL = "https://api.anthropic.com"

[[projects.platforms]]
type = "wecom"

[projects.platforms.options]
mode = "websocket"
bot_id = "你的Bot ID"
bot_secret = "你的Bot Secret"
allow_from = "*"

注意几个关键点:

  • mode = "websocket" — 用 WebSocket 长连接,不需要公网域名,这对国内开发者太友好了
  • allow_from = "*" — 允许所有人用,生产环境建议限制
  • API Key 可以用官方的,也可以用中转服务

3. 启动

cc-connect

看到这几行日志就说明成功了:

✅ wecom-ws: connected
✅ claudecode: agent initialized

然后打开企业微信,给机器人发条消息试试。

实际用起来有多爽?

场景一:地铁上修 Bug

你: 帮我看看 src/auth.py 的登录逻辑有没有问题
Bot:(读取文件)→ 返回分析结果,指出第 42 行有个空指针风险
你: 改一下
Bot:(自动修改代码)→ 修好了,还跑了一下测试

场景二:Code Review

你: /mode plan
你: 看看最近的 git diff,给个 review
Bot:(执行 git diff)→ 返回详细的代码审查意见

场景三:摸鱼写需求

你: /mode yolo
你: 新增一个用户注册接口,要邮箱验证
Bot:(全自动)→ 创建路由、写逻辑、加验证、写测试,一条龙

会话管理:随时接上次的进度

这个功能我觉得特别好——你可以随时恢复之前的对话上下文。

你: /list
Bot:
  #1 (active) - 14:30 - "修复登录Bug"
  #2         - 11:15 - "重构API"
  #3         - 昨天  - "写单元测试"

你: /switch 3
Bot: 已切换到会话 #3 "写单元测试"

你: 继续
Bot:(带着昨天的上下文继续工作)

/list 看会话列表,/switch 切过去,无缝衔接。上下文完整保留,不会丢。

权限模式:安全和高效率的平衡

四种模式随切随用:

模式 说明 适合场景
/mode auto Agent 自己判断要不要问 日常开发
/mode yolo 全自动,不问直接干 赶进度的时候
/mode plan 只规划不执行 先看看思路对不对
/mode default 每步都确认 谨慎操作

切换模型也不会丢上下文:

/model switch opus    # 切到 Opus(重度任务)
/model switch sonnet  # 切到 Sonnet(日常任务)

后台常驻运行

用 pm2 管理,开机自启动:

npm install -g pm2
pm2 start cc-connect -- --config ~/.cc-connect/config.toml
pm2 save
pm2 startup

或者简单粗暴:

nohup cc-connect > ~/.cc-connect/cc-connect.log 2>&1 &

安全建议(认真看)

说几个一定要做的事:

  • 限制使用人员:allow_from 不要用 *,指定具体的 user_id
  • 设置管理员:admin_from 只有管理员能切 yolo 模式
  • API Key 别泄露:别提交到 Git 仓库
  • 谨慎使用 yolo 模式:全自动化很爽,但也意味着 Agent 可以删文件
  • 定期更新:npm update -g cc-connect

和其他工具对比

有人可能问:这跟 OpenClaw、Cursor 有啥区别?

cc-connect OpenClaw Cursor
定位 AI编程助手聊天桥 完整AI助手平台 AI编程IDE
核心能力 远程操控本地Agent 日常办公+任务管理 代码编辑+AI辅助
接入平台 12+聊天平台 企业微信为主 桌面客户端
是否需要公网IP 大部分不需要 需要 不需要

简单说:cc-connect 专注一件事——让你在聊天软件里操控 AI 编程助手。 不做别的,就做这一件事,做得很轻很稳。

我的使用建议

如果你是独立开发者或小团队,我建议这么用:

  1. 日常开发用 auto 模式,让 Agent 自己判断权限
  2. 赶 Deadline 用 yolo 模式,但限制只有管理员能用
  3. Code Review 用 plan 模式,先看思路再决定
  4. 配一个便宜的 API 中转,比直连 Anthropic 便宜不少
  5. 把常用操作做成自定义命令,放在 ~/.claude/commands/custom/ 目录

总结

cc-connect 解决了一个很实际的问题:你不需要一直坐在电脑前才能让 AI 帮你写代码。

地铁上、咖啡馆里、甚至躺在被窝里,打开企业微信或 Telegram,给你的 AI Agent 发条消息就行。

它开源、免费、轻量、支持多平台。如果你在用 Claude Code 或者任何 AI 编程助手,值得试一下。

项目地址:github.com/chenhg5/cc-connect

有问题可以在评论区聊,或者直接去 GitHub 提 Issue。

Views: 72

WaveTerm:让 AI 编程助手住进你的终端

WaveTerm:让 AI 编程助手住进你的终端

如果你同时在用 Claude Code、Codex、OpenCode 等 AI 编程智能体,一定会遇到一个问题:开了一堆终端窗口,哪个在等输入、哪个跑完了、哪个卡住了,根本分不清。

WaveTerm(Wave Terminal)就是为解决这个问题而生的。它是一个开源的、AI 原生终端,可以在 macOS、Linux 和 Windows 上运行,天然支持多智能体并行工作流。

安装

Windows

从 GitHub Releases 页面下载安装包:

https://github.com/wavetermdev/waveterm/releases

下载 .exe 安装包,双击安装即可。

macOS

brew install --cask waveterm

Linux

# Debian/Ubuntu
sudo dpkg -i waveterm_*.deb

# Fedora
sudo rpm -i waveterm_*.rpm

Windows 用户必做:设置 Git Bash

Windows 上 WaveTerm 默认使用 PowerShell。如果你习惯 Git Bash(大部分 AI 智能体的脚本都基于 bash),需要手动配置:

wsh setconfig term:gitbashpath="C:\Program Files\Git\bin\bash.exe"

这个命令告诉 WaveTerm 用 Git Bash 替代默认 Shell。如果你的 Git 安装路径不同,改成对应的路径即可。

验证是否生效:重启 WaveTerm,在终端里输入 echo $SHELL,如果输出包含 bash 就说明配置成功。

wsh 命令速查

wsh 是 WaveTerm 的核心命令行工具,能让你的终端命令和 Wave 的图形界面互相通信。以下是常用命令:

配置管理

# 设置配置项
wsh setconfig <key>="<value>"

# 编辑配置文件(用内置编辑器打开)
wsh editconfig

# 查看当前主题
wsh setconfig term:theme

常用配置项:

配置键 说明 示例
term:gitbashpath Windows Git Bash 路径 "C:\\Program Files\\Git\\bin\\bash.exe"
term:theme 终端主题 dracula, default-dark
waveai:defaultmode AI 默认模式 "my-proxy"
waveai:showcloudmodes 是否显示云端模式 false

文件操作

# 在编辑器中打开文件
wsh edit <filepath>

# 查看文件信息
wsh file info <filepath>

# 读写文件
wsh file cat <filepath>
wsh file write <filepath> "内容"

# 远程文件操作(在远程机器上访问本地文件)
wsh file cat wsh://local/~/config/app.json

界面控制

# 设置当前 block 的背景图
wsh setbg <image_url_or_path>

# 设置 Tab 徽章(Badge)
wsh badge <icon> --color '<color>' --priority <num> [--beep]

# 清除徽章
wsh badge clear

# 发送系统通知
wsh notify "任务完成!"

Block 管理

# 在新 block 中运行命令(完成后自动关闭)
wsh run <command>

# 删除当前 block
wsh deleteblock

# 列出所有 blocks
wsh blocks list

连接管理

# SSH 连接
wsh ssh user@hostname

# WSL 连接(Windows)
wsh wsl

# 查看连接状态
wsh conn status

其他实用命令

# 设置/获取变量
wsh setvar <key> "<value>"
wsh getvar <key>

# 获取 Wave 安装路径
wsh wavepath

# 重新安装 wsh 扩展
wsh reinstall

结合 Claude Code 使用

这是 WaveTerm 最强大的场景。当你在 WaveTerm 中并行跑多个 Claude Code 会话时,WaveTerm 的 Badge 系统可以让你一眼看出哪个会话需要关注。

配置 Tab Badge

编辑 ~/.claude/settings.json,添加 hooks:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt",
        "hooks": [
          {
            "type": "command",
            "command": "wsh badge bell-exclamation --color '#e0b956' --priority 20 --beep"
          }
        ]
      },
      {
        "matcher": "elicitation_dialog",
        "hooks": [
          {
            "type": "command",
            "command": "wsh badge message-question --color '#e0b956' --priority 20 --beep"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "wsh badge check --color '#58c142' --priority 10"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "AskUserQuestion",
        "hooks": [
          {
            "type": "command",
            "command": "wsh badge message-question --color '#e0b956' --priority 20 --beep"
          }
        ]
      }
    ]
  }
}

配置完成后效果:

事件 Badge 图标 颜色 优先级 含义
需要权限审批 bell-exclamation 金色 20 Claude Code 在等你批准操作
询问用户 message-question 金色 20 Claude Code 在等你回答问题
会话完成 check 绿色 10 任务跑完了

当你在 WaveTerm 中开了 5 个 Claude Code Tab,一眼就能看到:

  • 金色感叹号 = 快去看看,卡住了
  • 绿色勾 = 已完成,有空再看
  • 什么都没有 = 还在跑,不用管

Badge 在你点击进入 Tab 后自动清除,纯粹的"提醒"信号。

自定义更多 Badge

你可以为任何 Claude Code 工具添加 Badge 提示:

{
  "matcher": "Bash",
  "hooks": [
    {
      "type": "command",
      "command": "wsh badge spinner --color '#00FFDB' --priority 5"
    }
  ]
}

可用的图标名来自 Font Awesome(去掉 fa- 前缀),颜色支持任何 CSS 颜色值。

结合 OpenAI Codex 使用

OpenAI Codex 同样是终端内运行的 AI 智能体,在 WaveTerm 中使用时可以:

# 在 WaveTerm 中直接启动 Codex
codex "帮我重构这个函数"

如果你同时跑 Claude Code 和 Codex,建议在 WaveTerm 中分不同 Tab 组织:

  • Tab 1: Claude Code(前端开发)
  • Tab 2: Codex(后端开发)
  • Tab 3: 测试/构建

每个 Tab 独立运行,互不干扰。

结合 OpenCode 使用

OpenCode 是另一个流行的终端 AI 工具,同样可以在 WaveTerm 中运行:

# 启动 OpenCode
opencode

# 或指定模型
opencode run "分析这段代码的性能问题" --model zhipuai-coding-plan/glm-4.7

多智能体并行工作流实战

场景:同时用 3 个智能体开发一个功能

  1. Tab 1 — Claude Code 做前端 UI
claude "实现用户登录页面,使用 React + TailwindCSS"
  1. Tab 2 — Codex 写后端 API
codex "创建 POST /api/login 接口,JWT 认证"
  1. Tab 3 — OpenCode 做代码审查
opencode run "审查 src/auth/ 目录下的所有文件,输出安全风险报告"

在 WaveTerm 中,三个 Tab 并行运行。Badge 系统让你随时知道谁在等你、谁完成了。点击有金色 Badge 的 Tab 处理完,继续做别的事。

高级技巧

远程开发:用 wsh ssh 连接远程服务器,在远程机器上运行 AI 智能体,同时 Badge 依然在本地显示。

# 连接远程服务器
wsh ssh user@your-server

# 在远程服务器上运行 Claude Code
claude "部署这个应用到 Kubernetes"

文件桥接:在远程机器上访问本地文件:

# 远程机器上读取本地配置
wsh file cat wsh://local/~/project/config.yaml

自动通知:长时间任务完成后通知你:

# 在智能体命令后面追加通知
claude "跑完整测试套件" && wsh notify "测试完成!"

常见问题

Q: Windows 上打开 WaveTerm 闪退?

检查 Git Bash 路径是否正确:

wsh setconfig term:gitbashpath="C:\Program Files\Git\bin\bash.exe"

Q: Claude Code Badge 不显示?

确认 ~/.claude/settings.json 中的 hooks 格式正确,然后重启 Claude Code 会话。

Q: 主题怎么换?

# 切换 Dracula 主题
wsh setconfig term:theme dracula

# 恢复默认
wsh setconfig term:theme default-dark

Q: 如何配置 AI 模型?

# 使用自定义 OpenAI 兼容 API
wsh setconfig waveai:defaultmode="my-proxy"

# 隐藏官方云端模式(只用自建 API)
wsh setconfig waveai:showcloudmodes=false

然后用 wsh editconfig 打开配置文件,编辑 API 地址和密钥。

总结

WaveTerm 的核心价值:

  • 多智能体并行:一个窗口管理 Claude Code、Codex、OpenCode 等多个 AI 助手
  • Badge 通知系统:一眼看出哪个智能体在等你,不用逐个切换检查
  • wsh 命令体系:打通终端命令和图形界面,文件桥接、远程操作一体化
  • 开源免费:跨平台,支持 macOS、Linux、Windows

如果你每天都在和多个 AI 编程助手打交道,WaveTerm 值得一试。

项目地址:https://github.com/wavetermdev/waveterm
官方文档:https://docs.waveterm.dev

Views: 88

告别 Vibe Coding:Claude Code + OpenSpec + Superpowers 工程化 AI 编程实战

告别 Vibe Coding:Claude Code + OpenSpec + Superpowers 工程化 AI 编程实战

AI 编程工具正在经历从"玩具"到"工程工具"的质变。很多人用 Claude Code 写代码,感觉就是在"凭感觉编程"(Vibe Coding)——代码能跑,但质量全看运气。问题不在工具,而在工作流。

今天介绍一套经过实战验证的组合:Claude Code + OpenSpec + Superpowers,把 AI 编程从"看心情"变成"真工程"。

三件套各自的角色

在建筑行业,盖一栋楼需要三种人:建筑师画蓝图、工程师施工、监理盯质量。AI 编程也一样。

OpenSpec — 建筑师(定义做什么)

OpenSpec 解决的是"AI 不知道你要什么"的问题。它不是简单的需求文档,而是一套结构化的项目规范体系:

  • API 文档(接口长什么样)
  • 架构决策记录 ADR(为什么选这个方案不选那个)
  • 任务列表(先做什么后做什么)

核心思路:先写规范,再写代码。这不是什么新概念,但 AI 编程时代很多人跳过了这一步,直接让 AI 写代码,结果就是反复返工。

Claude Code — 工程师(负责实现)

Claude Code 的角色就是你的搭档工程师。它根据 OpenSpec 定义的规范来编码,不是凭空想象。它能理解整个项目框架,支持代码补全、重构、复杂结构分析。

关键是:有了规范约束,Claude Code 的输出质量会显著提升。 没有规范的 AI 编程就像没有设计图的施工队,想一出是一出。

Superpowers — 监理(保证质量)

Superpowers 是 Claude Code 的技能插件,提供质量保障能力:

  • 测试驱动开发(TDD)
  • 代码审查
  • 风格一致性验证
  • 性能调优建议

代价是会增加 Token 消耗,但这笔投入换来的是可维护的代码。想想看,你是愿意多花 20% 的 Token,还是愿意花 3 个小时 debug AI 写出来的面条代码?

五步落地流程

第一步:安装 Claude Code

macOS / Linux:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

安装后运行 claude 验证并登录。

第二步:安装 OpenSpec 和 Superpowers

OpenSpec 是独立命令行工具,在本地终端安装:

npm install -g @fission-ai/openspec@latest

Superpowers 是 Claude Code 插件,在 Claude Code 交互界面中安装:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

安装后重启 Claude Code。

第三步:项目初始化

进入项目目录,运行初始化:

cd /path/to/your-project
openspec init

初始化向导会引导你配置,关键步骤:

  • 集成工具选择 Claude Code
  • 按提示复制初始化提示词到 Claude Code 粘贴

完成后项目会生成:

  • openspec/ 目录(规范文件)
  • AGENT.md(AI 行为指引)
  • CLAUDE.md(Claude Code 配置)

第四步:OpenSpec 工作流

OpenSpec 定义了标准化的三阶段工作流:

阶段一:提案(propose)

/opsx:propose add-dark-mode

AI 会自动生成:

  • proposal.md — 提案概要
  • specs/ — 详细规格
  • design.md — 设计方案
  • tasks.md — 任务分解

每个任务都有明确的输入、输出和验收标准。

阶段二:实施(apply)

/opsx:apply

Claude Code 按照 tasks.md 逐步执行,每完成一个里程碑更新状态。

阶段三:归档(archive)

/opsx:archive

将完成的变更归档到 openspec/changes/archive/,更新文档,保持项目整洁。

第五步:Superpowers 质量保障

在实施阶段,通过 Superpowers 触发质量检查:

/openspec:apply

这会启动 Superpowers 的自动化工作流,包括代码审查、测试验证、风格检查等。

和纯 Vibe Coding 的对比

维度 Vibe Coding OpenSpec 工作流
需求定义 口头描述,模糊 结构化文档,精确
代码质量 看运气 TDD + 自动审查
可追溯性 没有 ADR + 任务记录
团队协作 难以复现 规范即文档
返工率 高 低
Token 消耗 看似少,实际多(反复修改) 看似多,实际少(一次做对)

这套方案适合谁

适合:

  • 需要交付可维护代码的项目
  • 团队协作(规范文档就是最好的沟通工具)
  • 长期迭代的项目(每次变更有记录)

暂时不需要:

  • 一次性脚本
  • 快速原型验证
  • 学习阶段的练手项目

我的补充思考

OpenSpec 的核心价值不是工具本身,而是强制你先想清楚再动手。这一点和传统的软件工程方法论一脉相承——需求分析、设计、编码、测试,AI 只是加速了每个环节,但没有跳过任何一步。

Superpowers 的质量保障能力确实会增加 Token 消耗,但这是值得的投资。AI 编程最大的成本不是 Token 费,而是你花在修复 AI 生成低质量代码上的时间。

最后,这套工作流还在快速演进中。OpenSpec 和 Superpowers 都在积极迭代,建议关注官方更新,及时升级。

工具链接:

Views: 85

GitHub日榜第一的Skills神库:Matt Pocock如何用70行文件重塑AI编程纪律

GitHub 日榜第一的 Skills 神库:Matt Pocock 如何用 70 行文件重塑 AI 编程纪律

一个 TypeScript 圈的大佬,把自己每天用的 AI 编程技能包开源了,一周登顶 GitHub Trending。这不是框架,不是库,是一套经过实战检验的工程方法论。

这是什么

mattpocock/skills 是 TypeScript 社区知名开发者 Matt Pocock 开源的 Agent Skills 集合。目前 23,000+ Star,4/27 登顶 GitHub 热榜日榜第一。

它的定位很明确:Skills for Real Engineers, Not Vibe Coding(给真正的工程师用,不是玩票)。

核心理念是把软件工程几十年的最佳实践——TDD、领域驱动设计、架构重构——封装成 AI Agent 可以直接使用的技能包。每个 Skill 就是一个 Markdown 文件,描述了特定工程场景下的工作流程。

为什么火

三个原因:

1. 切中痛点。 AI 编程工具(Claude Code、Codex、Cursor)写代码很快,但质量参差不齐。常见的失败模式是:你以为 AI 懂你要什么,结果做出来完全不对。这些 Skills 就是解决"对齐"问题的。

2. 不夺权。 市面上的 GSD、BMAD、Spec-Kit 等方案试图接管整个流程,但这样你就失去了控制力。Matt 的 Skills 是"小而美"的,每个只解决一个问题,你可以自由组合。

3. 深度工程思维。 每个 Skill 背后都有经典工程书籍的支撑——《程序员修炼之道》《领域驱动设计》《软件设计哲学》《极限编程》。这不是拍脑袋想出来的。

核心 Skills 详解

整个仓库分为两大类:工程技能和通用工具。

/grill-with-docs — 最强技能

这是 Matt 自己说的"可能是本仓库最酷的技术"。

它的作用是在你动手之前,让 AI 对你的计划进行一轮"灵魂拷问":

  • 一个一个地提问,不批量轰炸
  • 能通过探索代码库回答的问题,AI 自己去查
  • 术语冲突时立刻指出:"你的 CONTEXT.md 定义 'cancellation' 为 X,但你刚才说的是 Y——到底是哪个?"
  • 当术语不够精确时,主动提出更好的词:"你说 'account',是指 Customer 还是 User?这是两个不同的概念"
  • 每确定一个术语就实时更新 CONTEXT.md

这个过程同时完成了两件事:统一语言和对齐需求。对齐之后,后续所有对话都建立在精确术语之上,AI 生成代码的准确度显著提升。

/tdd — 测试驱动开发

不是简单的"先写测试再写代码"。这个 Skill 强调垂直切片:

错误做法(水平切片):
RED: test1, test2, test3, test4, test5
GREEN: impl1, impl2, impl3, impl4, impl5

正确做法(垂直切片):
RED→GREEN: test1→impl1
RED→GREEN: test2→impl2
RED→GREEN: test3→impl3

水平切片的问题在于:批量写测试时你还不理解实现的细节,测试的是"想象中的行为"而非"真实的行为"。垂直切片则是一发一中的追踪弹——每次写一个测试,立刻实现,从上一轮学到的东西指导下一轮。

/to-prd 和 /to-issues — 需求拆解

/to-prd 把对话上下文直接合成 PRD(产品需求文档),提交为 GitHub Issue。不需要额外面试,直接把你们讨论的内容结构化。

/to-issues 则把 PRD 拆成独立可抓取的 GitHub Issues,使用垂直切片(Vertical Slices)的方式组织。

/triage — 问题分诊

通过状态机对 Bug 进行分角色诊断,自动化了"这个问题应该谁来处理"的决策流程。

/improve-codebase-architecture — 架构抢救

AI 加速了编码,但也加速了软件熵增。这个 Skill 帮你找出代码库中"深层化"的机会——把复杂逻辑藏到简单接口后面。Matt 建议每几天跑一次。

/diagnose — 纪律化调试

不是随意 print 调试,而是严格的循环:复现 → 最小化 → 假设 → 埋点 → 修复 → 回归测试。

/zoom-out — 退一步看全局

让 AI 跳出当前代码片段,在系统全局的视角下解释代码。防止 AI 在局部打补丁而忽略整体设计。

如何安装使用

一条命令搞定:

npx skills@latest add mattpocock/skills

然后选择你需要的 Skills 和目标 AI 编程工具(Claude Code、Codex 等)。

首次使用需要运行 /setup-matt-pocock-skills,它会:

  1. 问你用什么 Issue Tracker(GitHub、Linear 或本地文件)
  2. 问你用什么标签来分诊 Issue
  3. 问你文档存放在哪里
  4. 自动创建 CONTEXT.md 和 docs/adr/ 目录结构

之后在对话中直接用 /grill-me、/tdd 等命令调用对应 Skill。

背后的设计哲学

Matt 在 README 里引用了四本经典工程书籍,对应四个核心问题:

问题 引用 解决方案
需求不对齐 《程序员修炼术》"没人知道自己到底想要什么" /grill-me, /grill-with-docs
语言不统一 《领域驱动设计》"通用语言" CONTEXT.md + ADR
反馈太慢 《程序员修炼之道》"反馈速率是你的限速" /tdd 红绿循环
架构腐化 《软件设计哲学》"最好的模块是深的" /improve-codebase-architecture

这不是巧合——每个 Skill 都是某个经典工程原则的 AI 时代版本。

应用价值

对个人开发者: 如果你用 Claude Code 或类似工具写代码,这套 Skills 能让你的 AI 编程从"凭感觉"变成"有纪律"。特别是 /grill-with-docs,能让 AI 对需求的理解准确度上一个台阶。

对团队: CONTEXT.md 和 ADR(架构决策记录)天然适合团队协作。统一的领域语言减少了沟通成本,AI 生成的代码也更容易保持一致性。

对 AI 应用开发者: 这个仓库是"如何设计好的 Agent Skills"的活教材。每个 Skill 都是:单一职责、可组合、基于工程最佳实践、不绑定特定模型。如果你在设计自己的 Agent 系统的技能框架,值得逐个研读。

值得注意的细节

  • disable-model-invocation: true — 某些 Skill 禁止 AI 调用外部工具,确保它只做文档和对话层面的工作
  • Skills 不绑定特定模型,Claude、GPT、Gemini 都能用
  • 整个安装流程用 npx 一键完成,零配置
  • CONTEXT.md 的设计借鉴了 DDD 的通用语言(Ubiquitous Language),但做了极简化

总结

Matt Pocock 的 Skills 仓库之所以能登顶 GitHub,不是因为它多复杂——恰恰是因为它足够简单。它没有发明新的概念,而是把软件工程几十年验证过的最佳实践,用 AI Agent 能理解的格式重新表达了一遍。

在 AI 编程工具遍地走的时代,真正稀缺的不是"AI 能写多快的代码",而是"怎么确保 AI 写的是对的代码"。这个仓库给出了一个务实的答案。


项目地址: github.com/mattpocock/skills

Matt Pocock 的 Newsletter: aihero.dev(60,000+ 订阅者)

Views: 81

交互式需求发现:从模糊想法到具体规范

交互式需求发现:从模糊想法到具体规范

让 AI 成为你最好的需求分析师

前言

在实际项目中,很多需求一开始都是模糊的:

  • "我想做一个 AI 驱动的项目管理工具"
  • "需要加一个实时协作功能"
  • "我们要做一个数据分析平台"

传统的需求分析依赖人工,耗时长、易遗漏。而 AI 辅助的交互式需求发现,可以把这个过程从"几天"缩短到"几小时"。

本文将建立一套标准化的 AI 需求发现工作流,让你的需求分析从"碰运气"变成"可工程化"。


一、什么是交互式需求发现?

1.1 传统需求分析 vs AI 辅助需求发现

对比维度 传统需求分析 AI 辅助需求发现
时间 数天到数周 数小时到一天
成本 高(人力密集) 低(AI 自动化)
质量 依赖经验 系统性覆盖
一致性 因人而异 标准化流程
迭代 困难 快速迭代

1.2 核心理念:苏格拉底式对话

原则:

  • 不直接给答案,而是问问题
  • 通过系统性提问引导用户思考
  • 渐进式发现隐藏需求

示例:

用户:我想做一个项目管理工具

AI(❌ 错误):好的,我来设计一个项目管理工具...
   [直接跳到实现]

AI(✅ 正确):明白了。让我问几个问题帮助理清需求:
   1. 这个工具主要解决什么问题?
   2. 目标用户是谁?(个人、小团队、企业)
   3. 需要管理什么类型的项目?(软件开发、市场营销、通用)
   4. 是否需要实时协作功能?
   5. 数据安全性要求如何?

1.3 工作流程总览

模糊想法
   ↓
[探索阶段] 苏格拉底式对话
   ↓
[分析阶段] 多角色专业分析
   ↓
[验证阶段] 可行性评估
   ↓
[规范生成] 需求文档
   ↓
[移交阶段] 可执行简报
   ↓
具体规范

二、实际操作指南

2.1 触发方式

方式1:命令行触发

/sc:brainstorm "AI 驱动的项目管理工具" --strategy systematic --depth deep

参数说明:

  • --strategy systematic|agile|enterprise:策略模式

    • systematic:系统性探索(适合复杂项目)
    • agile:敏捷探索(快速迭代)
    • enterprise:企业级探索(强调安全、合规)
  • --depth shallow|normal|deep:探索深度

    • shallow:浅层探索(1-2 轮对话)
    • normal:正常探索(3-5 轮对话)
    • deep:深度探索(5+ 轮对话)
  • --parallel:并行探索(多角色同时分析)


方式2:自然语言触发

用户:我想做一个项目管理工具,但不确定具体功能
AI:好的,让我们一起来探索这个想法...

[自动进入 brainstorm 模式]

2.2 分阶段操作指南

阶段1:探索阶段(Explore)

目标:通过系统性提问理清需求

操作步骤:

  1. 启动探索

    用户:/sc:brainstorm "AI 驱动的项目管理工具"
    
    AI:好的,让我们开始探索这个想法。首先,我需要了解:
    
    【核心问题】
    1. 这个工具主要解决什么问题?
      - 任务跟踪混乱?
      - 团队协作困难?
      - 进度可视性差?
    
    2. 目标用户是谁?
      - 个人开发者
      - 小团队(5-20 人)
      - 中型企业(20-200 人)
      - 大型企业(200+ 人)
    
    请选择或补充你的想法。
  2. 用户回答

    用户:主要解决团队协作困难,目标用户是小团队(5-20 人)
  3. 渐进式深入

    AI:明白了。针对小团队的协作问题,让我进一步了解:
    
    【协作场景】
    1. 团队成员如何分配任务?
      - 手动分配
      - 自动匹配技能
      - AI 智能推荐
    
    2. 需要哪些协作功能?
      - 实时聊天
      - 文件共享
      - 任务评论
      - 视频会议
    
    3. 是否需要移动端支持?
    
    请告诉我你的偏好。
  4. 记录关键信息

    # 探索记录
    
    ## 核心需求
    - 解决团队协作困难
    - 目标用户:小团队(5-20 人)
    
    ## 协作需求
    - 任务分配:AI 智能推荐
    - 协作功能:实时聊天、任务评论
    - 移动端:需要
    
    ## 待确认
    - 视频会议是否需要?
    - 文件共享的具体需求?

阶段2:分析阶段(Analyze)

目标:多角色专业分析

角色分工:

角色 职责 关注点
架构师 系统设计 技术可行性、架构模式
分析师 可行性研究 成本效益、市场分析
前端 UI/UX 分析 用户体验、交互设计
后端 技术实现 数据结构、API 设计
安全 安全合规 数据安全、权限管理

操作示例:

AI:基于你的需求,我协调了多个角色进行分析:

【架构师分析】
- 推荐架构:前后端分离 + WebSocket 实时通信
- 技术栈建议:React + Node.js + PostgreSQL
- 理由:成熟稳定、开发效率高、适合小团队

【前端分析】
- UI 风格:简洁现代、移动端优先
- 关键页面:任务看板、团队聊天、日程视图
- 交互重点:实时更新、拖拽操作

【后端分析】
- 数据模型:用户、任务、团队、消息
- API 设计:RESTful + GraphQL(可选)
- 性能要求:支持 100 并发用户

【安全分析】
- 认证方式:JWT + Refresh Token
- 权限控制:基于角色的访问控制(RBAC)
- 数据加密:传输层 TLS + 存储层加密

【分析师建议】
- 市场定位:小型敏捷团队
- 竞品分析:Notion、Trello、Asana
- 差异化:AI 智能任务分配 + 实时协作

你觉得这个分析方向对吗?有需要调整的地方吗?

阶段3:验证阶段(Validate)

目标:可行性评估和需求验证

验证清单:

# 可行性验证清单

## 技术可行性
- [ ] 技术栈成熟稳定?✅
- [ ] 开发团队有相关经验?✅
- [ ] 第三方依赖可控?✅
- [ ] 性能要求可达成?✅

## 业务可行性
- [ ] 市场需求真实存在?✅
- [ ] 差异化竞争力明显?⚠️(需要强化 AI 功能)
- [ ] 商业模式可行?✅
- [ ] ROI 预期合理?✅

## 资源可行性
- [ ] 开发时间充足?✅(3 个月)
- [ ] 人力资源足够?⚠️(需要 1 个前端 + 1 个后端)
- [ ] 预算可控?✅

## 风险评估
| 风险项 | 影响 | 概率 | 缓解措施 |
|--------|------|------|----------|
| AI 功能不达预期 | 高 | 中 | 先做 MVP,逐步优化 |
| 竞品快速跟进 | 中 | 高 | 持续迭代,强化差异化 |
| 团队协作复杂 | 中 | 低 | 采用敏捷开发 |

操作示例:

AI:我整理了可行性验证报告:

✅ 技术可行:技术栈成熟,风险可控
⚠️ 竞争激烈:需要强化 AI 功能差异化
⚠️ 人力需求:需要 2 个全职开发人员

【建议】
1. 先做 MVP(最小可行产品),验证市场需求
2. 重点打磨 AI 任务分配功能
3. 采用敏捷开发,2 周一个迭代

你觉得这个方向可行吗?还是需要调整?

阶段4:规范生成(Generate)

目标:生成完整的需求文档

需求文档模板:

# 项目需求文档

## 1. 项目概述

### 1.1 项目背景
- **问题**:小团队协作困难,任务分配低效
- **目标**:构建 AI 驱动的项目管理工具
- **价值**:提升团队协作效率 30%

### 1.2 目标用户
- **主要用户**:小型敏捷团队(5-20 人)
- **次要用户**:中型团队(20-50 人)
- **用户画像**:
  - 项目经理:需要实时查看进度
  - 团队成员:需要接收任务、更新状态
  - 团队领导:需要数据分析、团队管理

---

## 2. 功能需求

### 2.1 核心功能

#### 功能1:AI 智能任务分配
**优先级**:P0  
**描述**:基于成员技能、工作负载、历史表现智能分配任务

**用户故事**:

作为一个项目经理,
我想要系统自动推荐最佳的任务分配方案,
以便提高团队效率,减少人工决策。


**验收标准**:
- ✅ 系统能识别成员技能标签
- ✅ 能计算成员当前工作负载
- ✅ 能推荐 Top 3 候选人
- ✅ 支持人工调整

---

#### 功能2:实时协作
**优先级**:P0  
**描述**:团队成员实时聊天、任务评论、文件共享

**用户故事**:

作为一个团队成员,
我想要在任务下直接评论和讨论,
以便快速沟通,避免信息分散。


**验收标准**:
- ✅ 支持实时消息推送(< 1 秒延迟)
- ✅ 支持富文本、表情、@提及
- ✅ 支持文件附件(≤ 10MB)
- ✅ 历史消息可检索

---

### 2.2 辅助功能

#### 功能3:看板视图
**优先级**:P1  
**描述**:可视化任务流转

**用户故事**:

作为一个项目经理,
我想要在看板视图中拖拽任务卡片,
以便直观管理任务状态。


---

## 3. 非功能需求

### 3.1 性能需求
- **响应时间**:页面加载 < 2 秒,操作响应 < 500ms
- **并发能力**:支持 100 并发用户
- **数据处理**:单团队支持 1000+ 任务

### 3.2 安全需求
- **认证**:JWT + Refresh Token
- **授权**:基于角色的访问控制(RBAC)
- **数据加密**:传输层 TLS 1.3,存储层 AES-256
- **合规**:符合 GDPR(如有欧洲用户)

### 3.3 可用性需求
- **可用性**:99.5% SLA
- **备份**:每日自动备份
- **恢复**:RTO < 4 小时,RPO < 1 小时

### 3.4 兼容性需求
- **浏览器**:Chrome 90+, Firefox 88+, Safari 14+
- **移动端**:iOS 14+, Android 10+
- **屏幕**:响应式设计,支持 320px-1920px

---

## 4. 用户故事

### 故事1:任务创建与分配

作为项目经理,
我想要快速创建任务并分配给团队成员,
以便推进项目进度。

验收标准:
✅ 能设置任务标题、描述、截止时间
✅ 能指定负责人、协作者
✅ 能设置优先级、标签
✅ 能附加文件、链接


### 故事2:进度追踪

作为项目经理,
我想要查看团队整体进度和个人工作负载,
以便及时调整资源分配。

验收标准:
✅ 看板视图显示任务流转
✅ 燃尽图显示项目进度
✅ 成员工作负载可视化
✅ 支持导出报告


---

## 5. 开放问题

### 待确认问题
1. **视频会议功能**:是否需要集成?(建议:第二期)
2. **第三方集成**:需要集成哪些工具?(Slack、GitHub、Jira?)
3. **离线支持**:是否需要离线模式?(技术复杂度高)
4. **AI 模型选择**:自研还是使用第三方 API?
5. **定价策略**:免费版功能范围?付费版定价?

### 风险项
1. **AI 功能效果**:智能分配是否真的有效?(建议:先做 MVP 验证)
2. **竞品压力**:Notion、Trello 功能已经很强大
3. **用户习惯**:团队是否愿意改变现有工具?

---

## 6. 下一步计划

### 6.1 立即行动
- [ ] 确认核心功能优先级
- [ ] 选择技术栈(React + Node.js + PostgreSQL)
- [ ] 设计数据库 Schema
- [ ] 绘制 UI 原型

### 6.2 后续工作
- [ ] 使用 <code>/sc:design 进行架构设计
- [ ] 使用 /sc:workflow 制定实施计划
- [ ] 使用 /sc:implement 开始编码

---

**文档版本**:v1.0  
**创建日期**:2026-03-31  
**作者**:AI 辅助需求发现

阶段5:移交阶段(Handover)

目标:创建可执行的简报,为实施做准备

移交清单:

# 项目移交清单

## ✅ 已完成
- [x] 需求探索完成
- [x] 多角色分析完成
- [x] 可行性验证通过
- [x] 需求文档生成
- [x] 开放问题记录

## 📋 交付物
- [x] 需求文档(REQ-20260331-001.md)
- [x] 用户故事清单(USER-STORIES.md)
- [x] 风险评估报告(RISK-ASSESSMENT.md)
- [x] 技术栈建议(TECH-STACK.md)

## 🔄 下一步
- [ ] 使用 <code>/sc:design 进行架构设计
- [ ] 使用 /sc:workflow 制定实施计划
- [ ] 使用 /sc:implement 开始编码

## 👥 相关人员
- **需求负责人**:张三
- **技术负责人**:李四
- **项目经理**:王五

## 📅 时间线
- **需求冻结**:2026-04-07
- **架构设计完成**:2026-04-14
- **开发启动**:2026-04-21

三、MCP 工具集成

3.1 核心工具

1. Sequential Thinking MCP

用途:系统性探索和复杂推理

应用场景:

  • 多步骤需求分析
  • 复杂业务逻辑推理
  • 风险评估和决策

使用示例:

// 使用 Sequential Thinking 进行需求分析
const analysis = await sequentialThinking.analyze({
  problem: "小团队协作困难",
  steps: [
    "识别核心问题",
    "分析根本原因",
    "探索解决方案",
    "评估可行性",
    "生成建议"
  ]
});

2. Context7 MCP

用途:框架特定的可行性评估

应用场景:

  • 技术选型分析
  • 框架对比评估
  • 架构模式推荐

使用示例:

// 使用 Context7 进行技术栈评估
const techStack = await context7.evaluate({
  requirements: {
    performance: "high",
    scalability: "medium",
    teamSize: "small"
  },
  frameworks: ["React", "Vue", "Angular"]
});

3. Magic MCP

用途:UI/UX 可行性分析

应用场景:

  • 用户界面设计评估
  • 交互模式分析
  • 设计系统集成

使用示例:

// 使用 Magic 进行 UI 可行性分析
const uiAnalysis = await magic.analyzeUI({
  userStory: "任务看板拖拽操作",
  targetUsers: "项目经理",
  devices: ["desktop", "mobile"]
});

4. Playwright MCP

用途:用户体验验证

应用场景:

  • 交互流程测试
  • 用户体验验证
  • 可用性测试

使用示例:

// 使用 Playwright 验证用户流程
const uxTest = await playwright.testFlow({
  flow: ["登录", "创建任务", "分配任务", "查看进度"],
  metrics: ["完成时间", "错误率", "满意度"]
});

5. Serena MCP

用途:跨会话持久化

应用场景:

  • 需求文档存储
  • 项目上下文管理
  • 跨会话记忆

使用示例:

// 使用 Serena 保存需求文档
await serena.save({
  projectId: "project-001",
  document: "requirements.md",
  content: requirementsDoc
});

// 跨会话加载
const savedDoc = await serena.load({
  projectId: "project-001",
  document: "requirements.md"
});

3.2 工具协调策略

策略1:串行执行(Sequential)

适用场景:复杂需求,需要逐步深入

Step 1: Sequential Thinking - 需求分析
   ↓
Step 2: Context7 - 技术评估
   ↓
Step 3: Magic - UI 分析
   ↓
Step 4: Playwright - UX 验证
   ↓
Step 5: Serena - 持久化存储

策略2:并行执行(Parallel)

适用场景:多维度分析,提高效率

┌─────────────────────────────────────┐
│  多角色并行分析                      │
├─────────────────────────────────────┤
│  ┌───────────┐  ┌───────────┐       │
│  │ 架构师    │  │ 分析师    │       │
│  │Context7   │  │Sequential │       │
│  └───────────┘  └───────────┘       │
│  ┌───────────┐  ┌───────────┐       │
│  │ 前端      │  │ 安全      │       │
│  │ Magic     │  │ Sequential│       │
│  └───────────┘  └───────────┘       │
└─────────────────────────────────────┘

四、实战案例分析

案例1:AI 驱动的项目管理工具

项目背景:

  • 客户:小型科技公司(20 人)
  • 痛点:团队协作困难,任务分配低效
  • 目标:构建 AI 驱动的项目管理工具

Step 1:启动探索

用户:/sc:brainstorm "AI 驱动的项目管理工具" --strategy systematic --depth deep

AI:好的,让我们开始系统性探索。

【第一轮:核心定位】
1. 主要解决什么问题?
   - 任务分配低效?
   - 进度跟踪困难?
   - 团队沟通不畅?

2. 目标用户规模?
   - 小团队(5-20 人)
   - 中型团队(20-100 人)
   - 大型团队(100+ 人)

3. AI 功能预期?
   - 智能任务分配
   - 进度预测
   - 风险预警

Step 2:深入分析

用户:主要解决任务分配低效,目标用户是 20 人的小团队,需要智能任务分配

AI:明白了。让我协调多个角色进行深入分析:

【架构师】
- 推荐技术栈:React + Node.js + PostgreSQL
- AI 方案:集成 OpenAI API(快速上线)
- 实时通信:WebSocket

【前端】
- 核心页面:任务看板、团队视图、AI 推荐
- 交互重点:拖拽操作、实时更新

【后端】
- 数据模型:用户、任务、技能标签、工作负载
- API 设计:RESTful + WebSocket

【安全】
- 认证:JWT + Refresh Token
- 权限:RBAC
- 数据:TLS + 加密存储

【分析师】
- 市场定位:小型敏捷团队
- 差异化:AI 智能分配(竞品少)
- MVP 建议:先做核心功能,2 个月上线

Step 3:验证可行性

AI:基于分析,我整理了可行性报告:

✅ 技术可行:技术栈成熟,AI API 可直接调用
✅ 市场需求:竞品少,差异化明显
⚠️ 资源需求:需要 2 个开发人员,2 个月

【风险评估】
- AI 效果不达预期(中)→ 先做 MVP 验证
- 用户习惯难改变(中)→ 提供免费试用

【建议】
1. 先做 MVP,验证 AI 分配效果
2. 重点打磨核心功能
3. 快速迭代,每月发布新版本

Step 4:生成需求文档

# AI 项目管理工具需求文档

## 核心功能
1. AI 智能任务分配(P0)
2. 实时协作(P0)
3. 任务看板(P1)
4. 进度追踪(P1)
5. 报表分析(P2)

## 技术栈
- 前端:React 18 + TypeScript + TailwindCSS
- 后端:Node.js 18 + Express + PostgreSQL
- AI:OpenAI GPT-4 API
- 实时:WebSocket (Socket.io)

## 时间线
- Week 1-2:UI 原型 + 数据库设计
- Week 3-6:核心功能开发
- Week 7-8:测试 + 上线

## 下一步
- [ ] 使用 <code>/sc:design 进行架构设计
- [ ] 使用 /sc:workflow 制定详细计划

案例2:实时协作功能

项目背景:

  • 客户:在线教育平台
  • 痛点:师生互动性差
  • 目标:添加实时协作功能

启动探索

用户:/sc:brainstorm "实时协作功能" --strategy agile --parallel

AI:好的,启动敏捷探索模式,并行分析:

【并行角色分析】
┌─────────────────┐
│ 前端分析        │
│ - 实时白板      │
│ - 共享编辑器    │
│ - 视频窗口      │
└─────────────────┘
┌─────────────────┐
│ 后端分析        │
│ - WebRTC        │
│ - WebSocket     │
│ - SFU 服务器    │
└─────────────────┘
┌─────────────────┐
│ 安全分析        │
│ - 端到端加密    │
│ - 权限控制      │
│ - 内容审核      │
└─────────────────┘

【综合建议】
- 技术方案:WebRTC(音视频)+ WebSocket(数据)
- 第三方集成:声网 Agora(降低开发难度)
- 安全方案:端到端加密 + 实时审核

五、最佳实践与注意事项

5.1 成功要素

要素1:系统性提问

原则:

  • 从宏观到微观
  • 从业务到技术
  • 从现在到未来

示例:

❌ 错误:你想要什么功能?
✅ 正确:
   1. 这个项目要解决什么问题?
   2. 目标用户是谁?
   3. 用户现在的痛点是什么?
   4. 你希望用户得到什么价值?

要素2:多角色思维

原则:

  • 不同角色看问题角度不同
  • 综合考虑才能全面
  • 避免单一视角盲区

示例:

需求:用户登录功能

【安全视角】
- 需要防止暴力破解
- 需要多因素认证

【用户体验视角】
- 登录流程要简单
- 支持第三方登录

【后端视角】
- Session 还是 JWT?
- 如何处理 Token 刷新?

要素3:渐进式深入

原则:

  • 不要一次问太多问题
  • 根据回答动态调整
  • 保持对话自然流畅

示例:

Round 1: 了解大方向
   "这个工具主要解决什么问题?"

Round 2: 细化需求
   "你提到任务分配,具体是哪种场景?"

Round 3: 技术细节
   "AI 分配算法,你希望基于什么因素?"

5.2 常见陷阱

陷阱1:过早跳到实现

错误:

用户:我想做一个项目管理工具
AI:好的,我来设计数据库 Schema...

正确:

用户:我想做一个项目管理工具
AI:明白了。让我先了解一些背景信息...
   [先探索,再实现]

陷阱2:忽略非功能需求

错误:

只关注功能需求,忘记性能、安全、可用性

正确:

【功能需求】
- 任务创建、分配、跟踪

【非功能需求】
- 性能:< 2 秒响应
- 安全:JWT 认证
- 可用性:99.5% SLA

陷阱3:需求镀金

错误:

用户:我想要一个简单的登录功能
AI:好的,我来设计多因素认证、生物识别、SSO...

正确:

用户:我想要一个简单的登录功能
AI:明白了。是用户名密码登录,还是需要第三方登录?
   [聚焦核心需求,不过度设计]

5.3 文档管理

原则1:版本控制

# 需求文档命名规范
REQ-20260331-001.md  # 日期 + 序号
REQ-20260331-002.md

# 版本记录
## v1.0 (2026-03-31)
- 初始版本

## v1.1 (2026-04-01)
- 新增实时协作功能需求
- 更新非功能需求

原则2:跨会话持久化

// 使用 Serena MCP 持久化
await serena.save({
  projectId: "project-001",
  phase: "brainstorm",
  documents: {
    requirements: "REQ-20260331-001.md",
    userStories: "USER-STORIES.md",
    risks: "RISK-ASSESSMENT.md"
  }
});

// 下次会话加载
const project = await serena.load({
  projectId: "project-001"
});

六、总结与展望

6.1 核心价值

效率提升:

  • 传统需求分析:数天到数周
  • AI 辅助需求发现:数小时到一天

质量保证:

  • 系统性提问,避免遗漏
  • 多角色分析,全面覆盖
  • 可行性验证,降低风险

标准化:

  • 统一的流程和模板
  • 可复用的最佳实践
  • 知识沉淀和传承

6.2 适用场景

场景 推荐策略 探索深度
新产品 systematic deep
功能迭代 agile normal
企业系统 enterprise deep
快速验证 agile shallow
复杂系统 systematic deep

6.3 未来方向

更智能的分析:

  • AI 自动识别矛盾需求
  • 智能推荐最佳实践
  • 自动生成技术方案

更好的协作:

  • 多人实时协作探索
  • 团队需求评审
  • 自动生成演示文稿

更深的集成:

  • 直接对接项目管理工具(Jira、Trello)
  • 自动创建开发任务
  • 持续跟踪需求变更

七、快速参考

7.1 命令速查

# 启动需求发现
/sc:brainstorm "项目想法"

# 系统性探索(复杂项目)
/sc:brainstorm "企业级应用" --strategy systematic --depth deep

# 敏捷探索(快速验证)
/sc:brainstorm "新功能" --strategy agile --depth shallow

# 并行分析(多维度)
/sc:brainstorm "跨平台应用" --parallel

7.2 模板速查

需求文档模板

# 项目需求文档

## 1. 项目概述
- 背景
- 目标
- 价值

## 2. 功能需求
- 核心功能
- 辅助功能

## 3. 非功能需求
- 性能
- 安全
- 可用性

## 4. 用户故事
- 故事1
- 故事2

## 5. 开放问题
- 待确认
- 风险项

7.3 检查清单

# 需求发现检查清单

## 探索阶段
- [ ] 核心问题识别
- [ ] 目标用户定义
- [ ] 业务价值明确

## 分析阶段
- [ ] 多角色分析完成
- [ ] 技术可行性评估
- [ ] 风险识别

## 验证阶段
- [ ] 可行性报告生成
- [ ] 优先级排序
- [ ] MVP 范围确定

## 生成阶段
- [ ] 需求文档完整
- [ ] 用户故事清晰
- [ ] 验收标准明确

## 移交阶段
- [ ] 交付物清单
- [ ] 下一步计划
- [ ] 相关人员确认

作者:PaPaBot
日期:2026-03-31
标签:需求发现、AI 辅助、Brainstorm、MCP

相关文章:

Views: 26

← Index