用途:基于代码库深度分析与用户输入,生成一份高层次的应用设计文档(Application Design Document),聚焦“做什么”而非“怎么做”,保持技术无关,供业务干系人、产品经理、设计师、新加入开发者及技术负责人阅读。
主要能力:分析项目结构与现有代码,读取 package.json 获取项目名与依赖,检查 .claude/rules/ 下已有文档,识别主要功能与模式;深入梳理应用结构、用户流程、数据模型、业务逻辑、外部集成与安全模式;先询问项目阶段(Pre-MVP、MVP、Production、Enterprise),再提 4-7 个业务与用户相关问题;根据阶段更新项目状态规则;生成设计文档并保存。
使用方式:触发时传入用户请求($ARGUMENTS)。流程为先分析代码库,再进行交互问答(必须先问项目阶段),随后更新 .claude/rules/3-project-status.mdc,最后生成文档。保存步骤包括:mkdir -p .claude/docs .claude/rules,将文档存为 .claude/rules/1-app-design-document.mdc。
文档结构:介绍、核心功能(按功能类别展开)、用户体验、系统架构、业务逻辑、未来考虑。写作原则为业务导向、强调用户价值、语言清晰、可用图示、考虑演进;不写代码片段、技术栈、数据库 schema、API 规格与具体性能指标。
适用场景:新项目立项或需要向非技术角色同步应用全貌时;需要统一团队对产品目标、用户角色、核心旅程与业务规则理解时。
限制:必须等待用户回答后才继续;项目阶段与上下文答案缺失时文档内容无法准确生成;具体技术栈细节另由后续文档(如 2-tech-stack.mdc)承载。其他收费、价格、平台与效果信息暂未提供。