用途
Project Research 面向“新项目启动”或“需要初始化代码库”的场景,帮助用户在 AI 代理开始写代码之前,明确项目范围、技术栈、设计语言和编码标准。它把项目启动拆成九个依次执行的阶段,并在每个阶段通过访谈收集信息,同时自动检索相关文档与最佳实践。
主要能力
- 分阶段工作流:项目愿景 → 技术栈发现 → 数据模型与实体设计 → 用户流程与故事 → 目标与编码风格 → 设计语言 → 项目护栏与 AI 协作约定 → 整体审查 → 编译输出。每个阶段必须创建任务并按顺序完成。
- 逐题访谈:一次只问一个问题,不批量提问;每个问题都提供选项(含“(Recommended)”推荐默认项和始终可用的“Other”自由输入),互斥选项可用 multiSelect;阶段之间先总结确认,再按回答自适应追问;对 CLI、API、无 UI 的库等跳过设计语言阶段。
- 自动研究:对识别出的每项技术,使用 Context7(resolve-library-id → query-docs)、llms.txt、最新官方文档搜索、最佳实践搜索、常见错误搜索,向用户呈现结论并做技术栈整体协调性复查(版本不兼容、更优替代、过时技术、重叠工具)。
- 渐进式保存(崩溃保护):每个草稿文件头部标注当前阶段与最后回答的问题;会话开始时若存在 PLAN.md.draft 或 CLAUDE.md.draft,则询问是否恢复,恢复后跳过已回答问题;每个回答后先更新草稿再问下一题。多数回答写入 PLAN.md.draft,只有产生可执行规则(代码风格、护栏、架构边界、命令、注意事项)时才更新 CLAUDE.md.draft。
- 已有代码审计:若存在现有代码,先读取目录结构(前 2-3 层)、检查 CLAUDE.md/README/package.json/配置文件、识别既有模式(测试框架、lint、目录结构),向用户总结并用于后续阶段。
- 原始意图留存:将用户最初描述逐字保存到 PLAN.md.draft 的“Original Vision > Raw user input”,作为需求源头。
- 编译输出:第 9 阶段生成/合并 CLAUDE.md 与 PLAN.md,经用户批准后把草稿提升为正式文件并删除草稿;若用户不批准则返回修订。
使用方式
按九阶段清单依次执行:先做项目愿景访谈(收集 what、why、who、范围、平台、MVP/生产、个人/团队、现有代码/设计、时间线),再做技术栈访谈与自动研究,随后依次完成数据模型、用户流程与故事、编码风格、设计语言、项目护栏、整体审查,最后编译输出。各阶段问题库与文件模板分别见 interview-questions.md 和 output-templates.md。
输出文件规范
- CLAUDE.md:每次会话都会加载,须控制在 80 行以内,只放可执行规则;只包含项目标识(1 行)、命令、非显而易见的代码风格规则、架构规则(不写“为什么”)、护栏、环境配置、注意事项;不包含研究、文档链接、最佳实践、数据模型、用户流程、设计规格、决策理由。
- PLAN.md:面向新开发者或 AI 可冷启动的完整项目文档,包含逐字原始输入、项目目标与愿景、技术栈及文档引用与最佳实践要点、数据模型、用户故事与流程、设计语言规格、带理由的架构决策、外部集成、分阶段实施计划、测试策略、已知风险与缓解、待解问题。
- 两文件须零重复(CLAUDE.md 中已有的内容在 PLAN.md 中改为引用)、零废话、可扫描(要点优先、结构化数据用表格)、具体(如“Use Zustand for client state”而非“考虑使用状态管理库”)、可执行。
适用场景
新项目启动、代码库初始化、需要定义项目范围与技术栈、需要确立设计语言与编码标准、希望在多次 AI 编码会话之间维持代码库健康(通过护栏与协作约定防止代码腐化)的场景。
限制
- 第 9 阶段的两份文件在写入前必须先交给用户审阅,写入后需用户批准才转正。
- 设计语言阶段对 CLI 工具、API、无 UI 的库不适用,应整体跳过。
- 具体针对每个技术的调研依赖 Context7 与网络搜索的可用性。