用途:把早期功能需求初稿整理成三份可落地文档——总览文档、前端实现文档、后端实现文档,并结合真实代码结构明确前后端职责、定义共享契约。
主要能力:总览文档包含目标、背景、范围、非目标、业务对象、端到端流程、跨端契约、Mermaid 图、上线规划、风险与验收标准,并用项目相对路径引用前后端文档;前端文档只写路由、页面、区块、组件、状态、Hook、接口接入点、交互状态、Mermaid 流程图、测试及可选 Pencil 设计稿占位;后端文档只写数据模型、迁移、接口路由、Schema、服务、校验、统计公式、任务、通知或事件、Mermaid 流程图、测试与验收标准。
使用方式:先读取仓库规则与相关 AGENTS.md,遵循本地文档风格、目录、命名和包管理约定;完整阅读需求初稿,识别目标、角色、业务名词、统计规则、UI、后端数据与通知诉求、隐含权限,不清楚的写入假设或待确认事项;用 rg 和定向阅读梳理现有页面、路由、组件、Hook、生成 API 客户端、模型、Schema、服务、测试、通知与统计逻辑,优先复用现有模块。三份文档命名一致、链接用项目相对路径,共享契约放总览,各实现文档只重复本端需消费部分。涉及新增 UI 表面时,先询问用户是否需要预留 Pencil 占位;需要时仅为真正新增的页面、视图、区块、面板或组件创建 .pen 文件,放在 docs/features/<feature>/pencil/<surface>.pen,空占位可只含 {"version":"2.13","children":[]};复用已有组件则标注不需要占位。最后校验链接、标题一致性、Mermaid 语法、职责边界与 JSON 格式,有仓库校验命令则运行,否则至少运行 git diff --check。
适用场景:需求初稿拆分为三份技术文档、粗略产品说明整理为可开发文档、写实现文档前先梳理代码模块与约定、需要补充 Mermaid 流程图或接口契约索引。
限制:不用于直接实现功能代码、只写不拆分的 PRD、在 Pencil 中绘制具体视觉稿、只做后端 API 设计或只做前端组件开发且无需三份文档的场景。Mermaid 节点文案含标点时需用引号包裹标签。具体收费、价格、平台与效果资料暂未提供。