Agent skill · product strategy · aiskillstore
agile-design-doc
生成面向敏捷开发团队的精炼设计文档。MVP导向，避免过度设计。使用场景：(1) 需要为新功能或系统模块生成设计文档 (2) 需要明确功能边界和交互流程 (3) 需要提供实现思路和关键方法 (4) 需要阐述技术难点和解决方案。该skill会先分析项目技术栈和现有组件，然后生成精炼、重点突出的设计文档。
Why this skill is useful
Generates tailored design documentation based on project technology stack and existing components, which the AI wouldn't reliably create on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
敏捷设计文档生成 核心原则 1. MVP导向，避免过度设计 敏捷开发以快速迭代为目标，不需要考虑所有边界情况 专注于核心功能，次要功能可以后续迭代 不要为了"完整性"而添加不必要的功能 2. 基于现有技术栈 必须先读取项目配置文件（pyproject.toml、package.json等）了解技术栈 复用现有组件，避免重复造轮子 设计方案必须与当前技术栈兼容 3. 清晰阐述设计意图 明确本次设计解决的问题或提供的功能 使用mermaid时序图展示交互流程 针对每个功能点给出实现思路和关键方法 复杂逻辑使用mermaid实现流程 提供示例代码说明关键实现 4. 精炼文档，面向技术人员 读者是开发者和了解业务的产品人员 避免冗长的背景介绍和废话 先了解现有组件，避免重复设计 工作流程 第一步：前置分析 在生成设计文档之前，必须先完成以下分析： 1.1 了解项目背景 1.2 识别技术栈 1.3 了解现有组件 第二步：设计文档生成 按照以下结构生成设计文档： 2.1 设计目标（1-2段） 2.2 功能列表（简洁列表） 2.3 交互流程（Mermaid时序图） mermaid sequenceDiagram participant User participant API participant Service participant DB User->>API: 请求 API->>Service: 调用 Service->>DB: 查询 DB-->>Service: 返回 Service-->>API: 结果 API-->>User: 响应 2.4 实现方案（核心部分） 针对每个功能点，按以下结构描述： 功能点名称 实现思路（2-3句话） 说明采用的技术方案 为什么选择这个方案 与现有组件的集成方式 关键方法（代码示例） 技术难点（如有） 描述难点 说明解决方案 提供参考链接或示例 2.5 数据模型（如需要） 2.6 接口定义（如需要） 第三步：质量检查 生成文档后，进行以下检查： 3.1 精炼度检查 [ ] 是否有冗长的背景介绍？ [ ] 是否有重复的内容？ [ ] 是否可以删除某些章节而不影响理解？ 3.2 重点突出检查 [ ] 设计目标是否清晰？ [ ] 功能列表是否简洁？ [ ] 时序图是否展示了核心交互？ [ ] 实现方案是否提供了关键方法？ 3.3 技术准确性检查 [ ] 技术栈是否与项目一致？ [ ] 是否复用了现有组件？ [ ] 代码示例是否正确？ 3.4 MVP导向检查 [ ] 是否包含了不必要的功能？ [ ] 是否可以简化某些设计？ [ ] 是否有可以后续迭代的内容？ 常见问题处理 Q1: 用户没有提供足够信息 Q2: 不确定是否需要某个功能 Q3: 技术栈不熟悉 参考资源 设计文档模板 - 标准设计文档模板
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/agile-design-doc