| name | project-start |
| description | 文档优先的 Agent 智能开发启动 Skill，通过无限询问初始化空项目的.claude 目录和文档优先系统，不假设任何前提直到所有配置确认完成 |
| aliases | ["project-start","project-init","doc-first-init","项目启动"] |
| commands | ["/project-start"] |
| author | Kei |
| triggers | ["新项目，初始化项目，创建文档，项目启动，帮我 setup 项目，创建新项目"] |
| version | 2.0.0 |
| metadata | {"category":"部署流程","type":"交互式初始化向导","patterns":["inversion","pipeline"],"interaction":"multi-turn","stages":"3","gating":"required"} |
project-start - 文档优先的 Agent 智能开发启动
用途
当用户需要初始化一个新项目时，通过无限询问模式将空项目完整初始化，包括：
.claude/ 标准目录配置（CLAUDE.md、progress.txt 等）- 文档优先系统配置（PRD、APP_FLOW、TECH_STACK 等）
- Agent 对话规约、上下文和对话模式定义
核心原则：
- 不假设任何前提：所有配置通过询问确认
- 无限询问模式：直到所有前提清晰才创建文档
- 文档优先：在编码之前建立完整的文档基础
- 分阶段执行：每阶段确认后再进入下一阶段
工作流程
阶段 0：启动与项目类型确认
步骤 0.1：欢迎与范围说明
🚀 **项目启动向导**
我将通过无限询问模式帮你初始化新项目，包括：
1. .claude/目录配置（CLAUDE.md、progress.txt、Agent 规约等）
2. 文档优先系统（PRD、APP_FLOW、TECH_STACK 等）
3. Agent 对话规约和上下文定义
**询问原则：** 不假设任何前提，直到你确认所有配置。
让我们开始。
步骤 0.2：项目基本信息
询问：
## 阶段 0：项目基础信息
请回答以下问题：
### 1. 项目名称
[输入项目名]
### 2. 项目类型
- Web 前端（React/Vue/Angular 等）
- Web 后端（Node.js/Python/Go 等）
- 全栈应用
- 移动端应用（React Native/Flutter 等）
- 库/框架
- 其他（请描述）
### 3. 团队规模
- 个人项目
- 小团队（2-10 人）
- 企业项目（10 人+）
### 4. 是否需要项目模板
- 是（推荐什么模板？）
- 否（完全自定义）
等待用户回答后，进入阶段 1。
阶段 1：.claude 目录初始化
步骤 1.1：CLAUDE.md 内容询问
逐项询问：
## 阶段 1：.claude 目录初始化
### 1.1 项目概述
**问题：**
- 用一句话描述项目的核心目标
- 项目要解决什么问题
- 目标用户是谁
---
### 1.2 技术栈
**问题：**
- 前端框架（如 React 18、Vue 3）
- 后端框架（如 Node.js + Express、Python + FastAPI）
- 数据库（如 PostgreSQL、MongoDB）
- 云服务/部署平台（如 Vercel、AWS）
- 其他关键技术（如 GraphQL、Redis）
---
### 1.3 代码规范
**问题：**
- 主要编程语言
- 代码风格约定（缩进、命名、导入顺序等）
- 是否使用 Linter（ESLint、Prettier 等）
- 提交信息规范（如 Conventional Commits）
---
### 1.4 开发命令
**问题：**
- 依赖安装命令
- 开发启动命令
- 构建命令
- 测试命令
- 其他常用脚本
---
### 1.5 Agent 对话规约
**问题：**
- 偏好什么对话模式（简洁/详细/分步骤）
- 是否需要特定的上下文管理方式
- 代码生成时的约束（如"先生成接口再实现"）
- 审查代码时的重点（如"优先关注安全性"）
---
### 1.6 重要约定
**问题：**
- 项目特定的开发约定
- 团队内部的工作流程
- 其他需要 Claude 长期记住的信息
步骤 1.2：逐项确认
每询问完一个子项，输出摘要供确认：
### 确认：CLAUDE.md - [子项名称]
基于你的回答，我将记录：
**[子项名称]：**
- [要点 1]
- [要点 2]
- ...
请确认：
- 回复「是」继续下一项
- 回复「否」修改内容
- 回复「跳过」暂不处理
步骤 1.3：其他.claude 文件
### 1.7 progress.txt 配置
**结构：**
# 项目进度追踪
## 项目信息
- 名称：[项目名]
- 类型：[类型]
- 创建：[日期]
## 状态
- 已完成：[]
- 进行中：[]
- 接下来：[]
## 当前阶段：[阶段名称]
是否采用此结构？或需要调整？
---
### 1.8 settings.local.json
**询问：**
- 是否需要配置特定的权限
- 是否需要配置 MCP 服务
- 是否需要配置 Hooks
---
### 1.9 agents/ 目录
**询问：**
- 是否需要预定义子代理（如 code-reviewer、debugger）
- 如需，请描述每个代理的职责
---
### 1.10 rules/ 目录
**询问：**
- 是否需要模块化的规则文件
- 如需，请描述规则类别（如 code-style.md、testing.md）
等待所有子项确认后，进入阶段 2。
阶段 2：文档优先系统初始化
步骤 2.1：说明文档结构
## 阶段 2：文档优先系统
我将创建以下文档结构：
docs/
├── main/ # 核心文档
│ ├── PRD.md # 产品需求文档
│ ├── APP_FLOW.md # 应用流程/架构
│ ├── TECH_STACK.md # 技术栈详情
│ ├── FRONTEND_GUIDELINES.md # 前端规范
│ ├── BACKEND_STRUCTURE.md # 后端结构
│ └── IMPLEMENTATION_PLAN.md # 实施计划
├── research/ # 调研报告
├── knowledge-base/ # 技术栈知识库、指南
└── reference/ # API 文档（供 Agent 引用）
是否确认此结构？或需要调整？
步骤 2.2：逐项询问文档内容
对每个文档进行无限询问：
PRD.md（产品需求文档）
### 2.2.1 PRD.md - 产品需求文档
**询问列表：**
1. 产品愿景：产品要实现的长远目标是什么
2. 问题陈述：当前存在什么问题需要解决
3. 目标用户：谁会使用这个产品，用户画像是什么
4. 核心功能：必须实现的功能列表（MoSCoW 优先级）
5. 非功能需求：性能、安全、可用性等要求
6. 成功指标：如何衡量产品成功（KPI、OKR）
7. 约束条件：时间、预算、技术等限制
8. 依赖关系：外部依赖、第三方服务
**询问方式：**
逐个问题询问，每个问题后确认理解是否正确：
"关于 [问题]，我的理解是：[复述]。是否正确？"
APP_FLOW.md（应用流程）
### 2.2.2 APP_FLOW.md - 应用流程/架构
**询问列表：**
1. 用户流程：用户从进入到完成目标的路径
2. 系统架构：整体架构图（单体/微服务/Serverless）
3. 数据流：数据如何在系统中流动
4. 核心模块：系统的主要组成部分
5. 接口设计：内部和外部接口定义
6. 状态管理：应用状态如何管理
7. 路由结构：页面/视图的组织方式
TECH_STACK.md（技术栈）
### 2.2.3 TECH_STACK.md - 技术栈详情
**询问列表：**
1. 前端技术栈：框架、UI 库、状态管理、构建工具
2. 后端技术栈：框架、ORM、认证、API 规范
3. 数据库：类型、版本、设计原则
4. 云服务：部署平台、CDN、存储
5. 第三方服务：支付、邮件、短信等
6. 开发工具：IDE、调试、测试工具
7. 版本管理：Git 流程、分支策略
FRONTEND_GUIDELINES.md（前端规范）
### 2.2.4 FRONTEND_GUIDELINES.md - 前端规范
**询问列表：**
1. 目录结构：前端代码的组织方式
2. 组件规范：组件设计原则、命名、props 定义
3. 样式规范：CSS 方案、命名约定、响应式
4. 状态管理：全局状态、本地状态、缓存策略
5. API 调用：请求封装、错误处理、loading 状态
6. 性能优化：懒加载、代码分割、缓存
7. 可访问性：a11y 要求
BACKEND_STRUCTURE.md（后端结构）
### 2.2.5 BACKEND_STRUCTURE.md - 后端结构
**询问列表：**
1. 目录结构：后端代码的组织方式
2. 路由设计：URL 规范、版本控制
3. 控制器规范：请求处理、响应格式
4. 数据模型：实体设计、关系定义
5. 服务层：业务逻辑组织
6. 认证授权：用户认证、权限控制
7. 错误处理：错误码、异常处理
8. 日志策略：日志级别、格式、存储
IMPLEMENTATION_PLAN.md（实施计划）
### 2.2.6 IMPLEMENTATION_PLAN.md - 实施计划
**询问列表：**
1. 里程碑：关键交付节点
2. 迭代计划：Sprint 划分、每轮目标
3. 任务分解：功能拆解为具体任务
4. 优先级：任务优先级排序
5. 时间估算：每项任务的时间预估
6. 风险管理：潜在风险和应对方案
步骤 2.3：其他文档目录说明
### 2.3 docs/ 其他目录
**research/** - 调研报告
- 用途：存放技术调研、竞品分析报告
- 初始化：创建目录和 README.md 说明
**knowledge-base/** - 技术栈知识库、指南
- 用途：存放团队知识库、最佳实践
- 初始化：创建目录和 README.md 说明
**reference/** - API 文档
- 用途：存放从调研、知识库中提取的 API 文档供 Agent 引用
- 初始化：创建目录和 README.md 说明
阶段 3：联动检测与启动报告
步骤 3.1：检测迁移 Skill
## 阶段 3：联动检测
正在扫描 `.claude/skills/` 目录...
发现以下 Skill：
- [Skill 1]
- [Skill 2]
- ...
检测到可能存在从其他项目迁移的 Skill，是否需要调用 `skill-adapter` 进行适配检查？
- 回复「是」调用 skill-adapter
- 回复「否」跳过
步骤 3.2：生成启动报告
# 项目启动完成报告
**项目名称：** [名称]
**初始化时间：** [日期时间]
**总询问轮次：** [N] 轮
## 已完成初始化
### .claude/ 目录
- [ ] CLAUDE.md
- [ ] progress.txt
- [ ] settings.local.json
- [ ] agents/
- [ ] rules/
### docs/ 目录
- [ ] docs/main/PRD.md
- [ ] docs/main/APP_FLOW.md
- [ ] docs/main/TECH_STACK.md
- [ ] docs/main/FRONTEND_GUIDELINES.md
- [ ] docs/main/BACKEND_STRUCTURE.md
- [ ] docs/main/IMPLEMENTATION_PLAN.md
- [ ] docs/research/
- [ ] docs/knowledge-base/
- [ ] docs/reference/
## 待补充内容
以下文档的内容需要后续补充：
- [列出待补充项]
## 下一步建议
1. [建议 1]
2. [建议 2]
3. ...
---
🎉 项目初始化完成！可以开始开发了。
输出格式
初始化报告格式
# 项目启动完成报告
**项目名称：** [名称]
**初始化时间：** [日期时间]
## 目录结构
[生成的目录树]
## 配置摘要
[各项配置的关键信息]
## 待补充内容
[需要后续完善的内容清单]
## 下一步建议
[行动建议列表]
踩坑清单
| 陷阱 | 错误做法 | 正确做法 |
|---|
| 假设技术栈 | "我猜你用的是 React" | "请告诉我你使用的前端框架" |
| 跳过确认 | 直接生成文档 | 每项配置后询问确认 |
| 遗漏 Agent 规约 | 只配置基础信息 | 必须包含对话规约和上下文 |
| 文档空洞 | 只创建空文件 | 通过询问填充实质内容 |
| 不检测联动 | 忽略已有 Skill | 检测并提示 skill-adapter |
示例
示例：完整初始化流程
用户： /project-start
响应流程：
🚀 项目启动向导
我将通过无限询问模式帮你初始化新项目...
## 阶段 0：项目基础信息
1. 项目名称？
2. 项目类型？
3. 团队规模？
4. 是否需要模板？
[用户回答后]
## 阶段 1：.claude 目录初始化
### 1.1 项目概述
[询问 → 确认]
### 1.2 技术栈
[询问 → 确认]
...（逐项进行）
## 阶段 2：文档优先系统
### 2.1 PRD.md
[无限询问直到确认]
### 2.2 APP_FLOW.md
[无限询问直到确认]
...（逐项进行）
## 阶段 3：联动检测与报告
[生成启动报告]
注意事项
无限询问原则
- 不假设任何前提
- 每项配置必须确认
- 用户说"跳过"才能跳过
- 问题数量取决于项目复杂度
文件安全
- 创建前确认文件不存在或覆盖
- 支持撤销操作
- 保留配置历史
联动触发
- 检测技能迁移时主动提示 skill-adapter
- 检测 MCP 需求时主动提示配置
资源索引
| 资源 | 文件 | 用途 |
|---|
| 文档模板 | references/doc-templates.md | 各文档模板 |
| 检查清单 | checklists/init-checklist.md | 初始化检查 |
| 项目模板 | templates/ | 项目类型模板 |
Skill 版本：1.0.0 | 作者：Kei | 创建日期：2026-03-26
