Menu
文档优先的 Agent 智能开发启动 Skill，通过无限询问初始化空项目的.claude 目录和文档优先系统，不假设任何前提直到所有配置确认完成
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/JackSmith111977/Knowledge-Base --skill project-startThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Based on SOC occupation classification
Showing SKILL.md
| 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"} |
当用户需要初始化一个新项目时，通过无限询问模式将空项目完整初始化，包括：
.claude/ 标准目录配置（CLAUDE.md、progress.txt 等）核心原则：
步骤 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.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.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：逐项询问文档内容
对每个文档进行无限询问：
### 2.2.1 PRD.md - 产品需求文档
**询问列表：**
1. 产品愿景：产品要实现的长远目标是什么
2. 问题陈述：当前存在什么问题需要解决
3. 目标用户：谁会使用这个产品，用户画像是什么
4. 核心功能：必须实现的功能列表（MoSCoW 优先级）
5. 非功能需求：性能、安全、可用性等要求
6. 成功指标：如何衡量产品成功（KPI、OKR）
7. 约束条件：时间、预算、技术等限制
8. 依赖关系：外部依赖、第三方服务
**询问方式：**
逐个问题询问，每个问题后确认理解是否正确：
"关于 [问题]，我的理解是：[复述]。是否正确？"
### 2.2.2 APP_FLOW.md - 应用流程/架构
**询问列表：**
1. 用户流程：用户从进入到完成目标的路径
2. 系统架构：整体架构图（单体/微服务/Serverless）
3. 数据流：数据如何在系统中流动
4. 核心模块：系统的主要组成部分
5. 接口设计：内部和外部接口定义
6. 状态管理：应用状态如何管理
7. 路由结构：页面/视图的组织方式
### 2.2.3 TECH_STACK.md - 技术栈详情
**询问列表：**
1. 前端技术栈：框架、UI 库、状态管理、构建工具
2. 后端技术栈：框架、ORM、认证、API 规范
3. 数据库：类型、版本、设计原则
4. 云服务：部署平台、CDN、存储
5. 第三方服务：支付、邮件、短信等
6. 开发工具：IDE、调试、测试工具
7. 版本管理：Git 流程、分支策略
### 2.2.4 FRONTEND_GUIDELINES.md - 前端规范
**询问列表：**
1. 目录结构：前端代码的组织方式
2. 组件规范：组件设计原则、命名、props 定义
3. 样式规范：CSS 方案、命名约定、响应式
4. 状态管理：全局状态、本地状态、缓存策略
5. API 调用：请求封装、错误处理、loading 状态
6. 性能优化：懒加载、代码分割、缓存
7. 可访问性：a11y 要求
### 2.2.5 BACKEND_STRUCTURE.md - 后端结构
**询问列表：**
1. 目录结构：后端代码的组织方式
2. 路由设计：URL 规范、版本控制
3. 控制器规范：请求处理、响应格式
4. 数据模型：实体设计、关系定义
5. 服务层：业务逻辑组织
6. 认证授权：用户认证、权限控制
7. 错误处理：错误码、异常处理
8. 日志策略：日志级别、格式、存储
### 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.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：联动检测与报告
[生成启动报告]
| 资源 | 文件 | 用途 |
|---|---|---|
| 文档模板 | references/doc-templates.md | 各文档模板 |
| 检查清单 | checklists/init-checklist.md | 初始化检查 |
| 项目模板 | templates/ | 项目类型模板 |
Skill 版本：1.0.0 | 作者：Kei | 创建日期：2026-03-26