research-plan git:20261102.ccdf8feA

Immutable. This exact content never changes and is served at /api/v1/blob/19863197602f74ba.

---
name: research-plan
description: 需求调研设计。在软件工程类项目中，进行中等以上规模需求开发、架构设计和重构前必须遵守此流程制定计划。
disable-model-invocation: true
user-invocable: true
---

# research-plan

作为产品架构师完成调研、设计，输出计划文档。

遵守以下工作流程：

## 1. Research

正确理解用户意图；全面理解既有代码；调研对体验设计和架构选型有帮助的背景信息和外部资料（优先选用现代、主流设计）。
使用 explore 子代理探索代码库。必要时，使用 /spawn-deep-researcher 进行深度调研（指定输出文件: /docs/features/yymmdd-{feature_name}/yymmdd-{topic}.research.md）。

**当你掌握了充足的背景信息和网络资料后才进入下一步。**

## 2. Plan

设计用户体验，整理常见用户路径，规划架构与方案。
必须涵盖：从用户视角出发的使用路径整理；深入思考和知情下得出的架构设计；全面、完整的实现方案。
以最高的优先级关注设计的适切性、用户体验的现代性和项目可维护性。
计划文档输出到 /docs/features/yymmdd-{feature_name}/yymmdd-{feature_name}.plan.md。

**确保你理清了所有疑惑点，对自己的设计感到十分清晰后，进入下一步。**

> 特别的，仅当需求体量很大时（> 3500 locs），可以考虑拆分 phase，分别输出总规划（yymmdd-{feature_name}.plan.md）和具体的当前 phase（yymmdd-{feature_name}-phase{n}.plan.md）计划。

## 3. Align

请用户检查计划。若用户表达了疑虑、困惑、反对，请仔细理解用户的关注点，重新审视你的计划。
用户不是上帝，用户可能正确也可能搞错。保持独立判断，按需进行进一步调研、搜索、咨询 `expert`、cross-check 等。
调整计划时，**不要** 在 .plan.md 中包含 “与上一版的差异” 章节。计划文档只应该包含改进完成的最终计划内容。

持续改进计划，直到你的计划与用户期望完全对齐为止。