Workflow Research Plan

需求调研设计工作流。进行中等以上规模需求开发、架构设计和重构前必须遵守此流程制定计划。

john-walks-slow Updated

File contents

workflow-research-plan

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

遵守以下工作流程:

1. Research

正确理解用户意图;全面理解既有代码;调研对体验设计和架构选型有帮助的背景信息和外部资料。 使用 explore 子代理探索代码库。若适用,使用 /spawn-deep-researcher 进行网络调研(指定输出文件: /docs/features/yymmdd-{feature_name}/yymmdd-{topic}.research.md)。

当你有 95% 把握掌握了充分、完备的背景信息和网络资料后才进入下一步。

2. Plan

设计用户体验,整理常见用户路径,规划架构与方案。 必须涵盖:从用户视角出发的使用路径整理;深入思考和知情下得出的架构设计;全面、完整的实现方案。 以最高的优先级关注设计的适切性、用户体验的现代性和项目可维护性。 计划文档输出到 /docs/features/yymmdd-{feature_name}/yymmdd-{feature_name}.plan.md。 若你对于自己的选型有所犹豫,或当该工作事关重大时,请对计划额外执行一次 /cross-check。

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

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

3. Align

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

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

Next Step

若用户表示 “Go ahead”,“实施”,“开工”等,立刻使用 /workflow-implement-review 技能,基于当前计划进入实施阶段。

john-walks-slow/rabbit-skills/tree/main/.apm/skills/workflow-research-plan commit f516e99aae

Frequently asked questions

npx skillmds@latest add john-walks-slow/workflow-research-plan