用途
project-planning 是一个专为 Web 应用项目设计的规划助手技能，用于生成结构化的规划文档。它把整个开发过程拆解为多个可独立完成的实施阶段，并为每个阶段定义文件清单、任务列表、验证标准与退出条件，目标是让每个阶段都能在单次会话内完成并验证。
主要能力
该技能可生成以下文档（IMPLEMENTATION_PHASES.md 为始终生成，其余按需生成）：
- IMPLEMENTATION_PHASES.md（始终生成）
- DATABASE_SCHEMA.md（数据模型较重要时）
- API_ENDPOINTS.md（API 接口较复杂时）
- ARCHITECTURE.md（存在多个服务或 worker 时）
- UI_COMPONENTS.md（UI 需要规划时，包含与阶段对齐的 shadcn/ui 安装策略）
- CRITICAL_WORKFLOWS.md（存在复杂或顺序敏感的设置步骤时）
- INSTALLATION_COMMANDS.md（按阶段可复制粘贴的命令）
- ENV_VARIABLES.md（密钥与配置指南）
- TESTING.md（需要记录测试策略时）
- AGENTS_CONFIG.md（项目使用 AI 智能体时）
- INTEGRATION.md（第三方集成较多时）
- 精简版 SESSION.md 跟踪模板（少于 200 行）
使用方式
技能内置推荐工作流：
- 提出 3-5 个澄清问题（认证、数据、功能、范围）
- 等待用户回答
- 立即创建规划文档（IMPLEMENTATION_PHASES.md 始终生成，其余按需）
- 将全部文档输出给用户审阅
- 确认用户满意
- 建议创建 SESSION.md 并开始 Phase 1
同时提供两个自动化斜杠命令：
- /plan-project：为新项目自动化规划，生成 IMPLEMENTATION_PHASES.md + SESSION.md + git commit。
- /plan-feature：为已有项目自动化功能规划，生成阶段、整合到 IMPLEMENTATION_PHASES.md 并更新 SESSION.md。
阶段类型与规划规则
技能定义了六类阶段：Infrastructure、Database、API、UI、Integration、Testing。每类阶段都有对应的适用时机、范围、文件数区间、时长区间与验证要求（如 API 阶段测试各 HTTP 状态码，UI 阶段测试用户流程与表单校验，Database 阶段测试 CRUD 与约束关系，Integration 阶段测试服务连通与错误处理）。
每个生成的阶段都必须满足上下文安全规则：单阶段触及文件数上限 5-8 个，不依赖对超过 2 个其他阶段的深入理解，实施加验证加修复应能在一个 2-4 小时的会话内完成。若阶段超出规模，技能会自动建议拆分（例如把“Complete User Management”拆为 4a 用户 CRUD API 与 4b 用户资料 UI）。每个阶段必须包含：类型、预估时长、文件清单、有序任务清单、验证标准复选框、退出条件。
默认技术栈
除非用户另有说明，技能默认采用：前端 Vite + React + Tailwind v4 + shadcn/ui；后端 Cloudflare Workers with Static Assets；数据库 D1（SQL 与迁移）；存储 R2 与 KV；认证 Clerk（JWT 校验与自定义模板）；状态管理 TanStack Query（服务端）与 Zustand（客户端）；表单 React Hook Form + Zod；部署 Wrangler CLI；运行时 Cloudflare Workers（非 Node.js）。仅当用户提及非标准技术、项目有特殊需求或 Cloudflare 技术栈不合适时，技能才会询问技术栈选择。
适用场景
适合需要为 Web 应用项目产出结构化实施计划、希望控制每次工作时长与上下文规模、并需要明确验证与退出标准的开发者。也适合已有项目新增功能时，通过 /plan-feature 将新阶段并入既有规划。
限制
资料未提供该技能的收费、价格、平台限制或实际效果说明，暂未提供。具体能力以本技能描述中列出的文档生成与阶段规划为准，未提及的功能不做保证。