메뉴
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