# AI项目规划文档生成

`项目规划` `文档生成` `Claude技能` `软件架构` `AI辅助开发`

# 注意：建议查看此仓库以获取增强版规格文档技能 -> https://github.com/adrianpuiu/specification-document-generator

# 项目规划技能 - 即将删除，此版本已过时，将被以下项目替代 -> https://github.com/adrianpuiu/specification-document-generator

一个综合性技能，将 Claude 定义为**项目架构师**角色，用于生成详细的规划文档，作为 AI 辅助软件开发的蓝图。

## 技能功能

本技能将 Claude 转变为系统架构师，通过以下方式创建完整的项目文档：

1. **预先定义完整的系统架构** - 所有组件、数据流和集成点
2. **设定明确的项目边界** - 范围内、范围外的内容及关键约束
3. **创建可追溯的文档** - 需求 → 设计 → 实现任务

本技能生成三份核心文档：

1. **需求文档** - 带有可测试验收标准和可追溯 ID 的用户故事
2. **设计文档** - 完整的系统架构，包含组件图、数据流和集成规范
3. **实现计划** - 带需求追溯和明确交付物的层级任务分解

## 架构师方法论

**有效原因：** 预先设定清晰的角色、职责和交付物，能显著提升输出质量。通过在深入细节之前明确定义系统组件、数据流和集成点，文档将变得全面且可执行。

## 快速开始

### Claude 安装

```bash
/plugin marketplace add adrianpuiu/claude-skills-marketplace

/plugin install project-planner-skill@claude-skills-marketplace
```

## 文档类型

### 需求文档
- 标准格式的用户故事
- 使用 SHALL 语句的可测试验收标准
- 用于追溯的需求编号
- 领域术语词汇表

### 设计文档
- 系统架构图
- 组件职责与接口
- 数据模型与模式
- 错误处理策略
- 部署配置

### 实现计划
- 层级任务分解
- 需求追溯（将任务链接到需求）
- 任务间依赖管理
- 带复选框的进度跟踪

## 支持的项目类型

- **web-app**：全栈 Web 应用
- **cli-tool**：命令行工具和实用程序
- **api-service**：REST/GraphQL API 服务
- **generic**：通用项目

## 包含文件

### 脚本
- `generate_project_docs.py` - 自动化文档生成
- `validate_documents.py` - 文档验证与完整性检查

### 参考资料
- `domain-templates.md` - 领域特定模板和模式

### 资源
- `requirements-template.md` - 基础需求文档模板

## 最佳实践

1. **从需求开始** - 先定义系统应做什么，再考虑如何实现
2. **保持具体** - 使用可衡量的标准（如"100ms 以内"而非"快速"）
3. **追溯需求** - 将每个任务链接回需求
4. **包含非功能性需求** - 性能、安全性、可扩展性
5. **定义清晰的接口** - 明确组件如何交互
6. **增量规划** - 将大任务拆分为更小的可管理单元

## 常见使用场景

### 启动新项目
```
用户："我想构建一个实时聊天应用"
AI：[使用本技能生成完整的项目文档]
```

### 扩展现有项目
```
用户："为我的项目需求添加用户认证"
AI：[添加带有验收标准的规范格式需求]
```

### 创建技术规范
```
用户："为微服务电商平台设计架构"
AI：[生成包含组件、接口和部署的设计文档]
```

## AI 实现建议

在使用这些文档进行 AI 辅助开发时：

1. **需求优先** - 按需求优先级顺序实现
2. **遵循任务依赖** - 先完成前置任务
3. **对照验收标准测试** - 每条 SHALL 语句都是一个测试用例
4. **参考设计接口** - 使用规定的 API 和数据模型
5. **跟踪进度** - 在实现计划中勾选已完成的任务

## 验证清单

在使用文档进行实现之前：

- [ ] 所有占位符（[PLACEHOLDER]）已填写
- [ ] 需求具有可测试的验收标准
- [ ] 设计包含所有主要组件
- [ ] 任务引用了需求 ID
- [ ] 任务间依赖关系已识别
- [ ] 非功能性需求已明确
- [ ] 包含部署配置

## 输出示例

生成的文档遵循行业标准格式，具备以下特点：
- **机器可读** - 结构化以便 AI 解析
- **人类可读** - 开发者易于理解
- **版本控制友好** - 纯文本 Markdown 格式
- **可追溯** - 需求在所有文档中相互链接

本技能将高层次的项目构想转化为可执行的规范，供 AI 智能体用于构建可运行的软件。