Project Guide

---
name: project-guide
description: "引导用户填写项目开发指导模板。激活条件：用户想要开发新项目、表达项目需求、创建应用。"
---

# 项目开发指导助手

## 概述

这个 Skill 用于引导和帮助用户完成项目开发指导模板的填写。当用户想要开发新项目或对现有项目进行重大修改时，使用此 Skill 来收集必要的信息。

## 触发条件

在以下情况下应该激活此 Skill：
1. 用户表达想要开发一个新项目
2. 用户提到"帮我整理一下项目需求"
3. 用户想要使用 AI 开发应用但不知道如何描述需求
4. 用户说"我要做一个 XX 系统"
5. 用户询问如何开始一个项目开发

## 工作流程

### 阶段一：项目概览采集

**目标：** 收集项目的基本信息

需要询问用户以下问题：

1. **项目名称**
   - "你希望给项目起什么名字？"
   - 或者 "这个项目叫什么？"

2. **项目类型**
   - "这是一个什么类型的项目？Web应用、移动端、API服务还是桌面工具？"

3. **项目简介**
   - "能用一两句话描述一下这个项目吗？它是做什么的？"
   - "这个项目要解决什么问题？"

4. **核心目标**
   - "你做这个项目最主要想要达成什么目标？"
   - "除了主要目标，还有其他期望吗？"

### 阶段二：详细需求采集

**目标：** 收集详细的功能和业务需求

需要引导用户填写 `requirements.md`，询问：

1. **用户群体**
   - "谁会使用这个产品？"
   - "他们有什么特点和需求？"

2. **核心功能**
   - "这个产品最核心的功能是什么？"
   - "用户最常用的功能有哪些？"
   - "有没有必须有的功能（P0），重要但不是必须的功能（P1），以及可选功能（P2）？"

3. **业务流程**
   - "能描述一下典型的使用流程吗？"
   - "比如用户进来后第一步做什么，然后呢？"

4. **数据需求**
   - "需要存储什么类型的数据？"
   - "有没有用户账号体系？需要哪些信息？"

5. **非功能需求**
   - "对性能有要求吗？比如响应时间、并发数？"
   - "有安全或合规方面的要求吗？"
   - "需要支持哪些平台或浏览器？"

### 阶段三：技术约束采集

**目标：** 了解技术方面的限制和要求

1. **技术偏好**
   - "有没有偏好的技术栈？比如必须用某种语言或框架？"
   - "团队对哪些技术比较熟悉？"

2. **已有资源**
   - "有没有已经可以复用的组件或服务？"
   - "需要集成哪些第三方服务？"

3. **约束条件**
   - "预算或时间有限制吗？"
   - "有没有必须兼容的现有系统？"

### 阶段四：生成文档

**目标：** 将收集到的信息整理成完整的模板文档

1. 根据收集的信息，生成/更新 `main.md`
2. 根据收集的信息，生成/更新 `requirements.md`
3. 如果用户已确定技术选型，生成 `architecture.md`
4. 如果涉及接口，生成 `api.md`

## 输出格式

完成信息收集后，应该：

1. **总结确认**
   - 向用户确认理解是否正确
   - 询问是否有遗漏或需要补充的地方

2. **提供下一步建议**
   - "根据你提供的信息，我已经整理出项目模板。"
   - "接下来你可以："
     - "1. 查看并完善 templates 目录下的模板文件"
     - "2. 确认无误后告诉 AI '请从 main.md 开始阅读'"
     - "3. AI 将根据这些信息开始项目开发"

## 模板文件位置

项目模板位于 `templates/` 目录下：
- `templates/main.md` - 项目概览和索引
- `templates/requirements.md` - 详细需求文档
- `templates/architecture.md` - 技术架构设计
- `templates/api.md` - API 接口设计
- `templates/update.md` - 需求变更记录

## 注意事项

1. **循序渐进**：不要一次性问所有问题，而是根据用户的回答逐步深入
2. **解释原因**：适时解释为什么需要这些信息，帮助用户理解
3. **提供示例**：如果用户不知道如何描述，可以提供示例
4. **记录不确定**：对于用户不确定的地方，先记录下来，后续再确认
5. **保持简洁**：问题要简洁明了，避免过度技术化的术语