القائمة
Use when 用户说「先搜一下」「有没有现成库 / 工具 / MCP」「查一下 X 最佳实践」「技术选型」「调研 X」「先搜后写」「deep research」, or 在动手实现前需要把能复用的方案找出来,or 做技术决策前需要拉齐外部证据。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when 用户调用 /design-plan, or 需要为复杂跨服务需求(多服务改动 / 数据库 DDL / 新增对外接口 / 架构调整)产出可评审的技术方案文档,典型用户是技术主管 / 资深研发。简单单服务改动走 /workflow-spec,Bug 修复走 /fix-bug。
Use when asked to review a diff, do a pre-commit code review, or review staged/branch changes. Supports staged diffs, branch diffs, and session mode that reviews only files edited in the current conversation context.
Use when 用户调用 /plan-archive, or 三阶段研发流程的阶段三:在所有模块研发上线后,根据实际代码改动回写阶段一技术方案 + 项目级架构文档(docs/architecture / docs/contracts / docs/assets/概要设计 等)。
Use when 用户说「快速规划」「轻规划」「不走 workflow」「plan 一下」「quick plan」, or 需求清晰、作用域明确、可一次性规划完成的简单到中等任务。复杂项目(跨 module / 新子系统 / 需追溯)或需要正式需求文档 / PRD 请用 /workflow-spec。
Use when 用户调用 /spec-bootstrap, or 项目尚未建立 .claude/code-specs/ 骨架且需要初始化 code-specs 体系。
Use when 用户调用 /spec-update, or 工作中沉淀出新 convention / 接口 contract / 模式需要落到 .claude/code-specs/, or execute 末尾终审（workflow-execute Step 7）建议沉淀 code-spec。
| name | research |
| description | Use when 用户说「先搜一下」「有没有现成库 / 工具 / MCP」「查一下 X 最佳实践」「技术选型」「调研 X」「先搜后写」「deep research」, or 在动手实现前需要把能复用的方案找出来,or 做技术决策前需要拉齐外部证据。 |
| argument-hint | [--internal | --external] <需求 / 研究主题> |
不重复造轮子 + 不基于过期知识做决策。
/research <需求 / 研究主题> # 自动路由
/research --internal <功能需求> # 仅代码库 + npm/PyPI
/research --external <研究主题> # 仅外部引文
| 信号 | 模式 |
|---|---|
| "有没有现成 / 工具 / 组件 / MCP / 库"、具体功能描述 | internal |
| "最佳实践 / 技术选型 / 对比 / trade-off"、概念研究 | external |
| 既要找库又要对比方案 | 混合(先 internal 再 external) |
不确定时先问用户一句。
搜索范围:
| 来源 | 方法 |
|---|---|
| 代码库 | 本地代码检索 |
| npm / PyPI | Web 搜索 |
| GitHub | Web 搜索 |
| MCP 工具 | 检查已安装 MCP server |
评估维度: 适配度 / 维护性(最近更新?) / 依赖代价 / 集成成本 / 许可证
决策:
| 结论 | 条件 | 输出 |
|---|---|---|
| Adopt | 满足 > 80% | 安装命令 + 集成示例 |
| Extend | 满足 50–80%,可扩展 | 基础包 + 扩展方案 |
| Build | 无合适或集成代价过高 | 自建方案 + 参考代码 |
工具优先级: mcp__firecrawl__* → mcp__exa__search → read_url_content → Web 搜索。不可用时自动降级。
产出格式:
# 研究报告: [主题]
## 摘要
[2-3 句核心发现]
## 关键发现
### [发现 1]
[内容] [^1]
### [发现 2]
[内容] [^2]
## 建议
[基于研究的行动建议]
## 不确定性与限制
[未证实的信息]
## 参考来源
[^1]: [URL] - [日期] - [标题]
[^2]: [URL] - [日期] - [标题]
质量底线: 核心断言至少 1 个来源;官方文档优先;过期信息(> 2 年)标注;矛盾信息列多方观点。
/workflow-spec 代码分析阶段可触发本 skill/grill 质询中需要外部证据 → 跳到本 skill/fix-bug 怀疑第三方库 bug → --external 查 issue / changelog