| name | product-design |
| description | 用于规范项目文档目录与指导具体文档的编写(包含需求文档、设计文档和原型等)。适用于创建或更新 docs/project.md、docs/modules/<module>/requirements.md、design.md、design-server.md、prototype/*.html、docs/execplans/<module>-task.md。 |
| metadata | {"author":"weilei","version":"2026.02.12"} |
何时使用
当用户提出以下需求时使用本技能:
- 初始化或重构
docs/ 文档结构
- 新增模块文档目录
- 编写或更新产品需求/设计文档
- 让 AI 在编码前先沉淀完整上下文与任务拆解
目标
在 docs/ 下建立稳定、可追踪、对 AI 友好的文档资产,确保开发输入完整一致。
标准目录(必须遵守)
docs/
├─ project.md
├─ index-template.html
├─ reference-images/ (optional)
│ └─ *.{png,jpg,jpeg,webp,svg}
├─ execplans/
│ └─ <module-name>-task.md
└─ modules/
└─ <module-name>/
├─ requirements.md
├─ design.md
├─ design-server.md
├─ prototype/
│ ├─ index.html
│ └─ *.html
规则:
- 模块目录名使用短横线小写,如
tag-manage
<module-name>-task.md 统一放在 docs/execplans/,且 <module-name> 必须与模块目录名一致
- 新建原型页面优先从
docs/index-template.html 复制后改造
docs/reference-images/ 为可选目录,由用户手动放置参考图片;可先浏览这些图片提取可借鉴点(如信息层级、布局节奏、视觉风格),仅作为参考,最终方案仍以需求和设计判断为准
文件编写规范
docs/project.md
- 由AI和用户手动共同协作完成
- 只写全局信息:项目目标、范围、里程碑、统一约束
requirements.md
- 由AI和用户手动共同协作完成
- 记录原始需求,不提前替换成技术方案
design.md