Project Planner：用结构化文档规划软件项目

技能简介

Project Planner 是一款面向软件项目前期的 Agent 技能，直击一个老问题：项目失败往往不是因为代码写不动，而是因为在动工之前，需求、设计选择与任务拆分都没说清楚。该技能把模糊的项目想法转化为一套结构化、可追溯的规划文档，让 Claude、Codex、Claude Code 在实现之前先有一份清晰的地图。

它的产出分为三类核心文档：需求文档、系统设计文档与实施计划文档。三者之间通过需求 ID 相互追溯，任务与需求一一对应，避免"写着写着就忘了当初为什么这么设计"。技能质量为 86 分，属 featured 级别，MIT 许可。

核心能力

1. 生成需求文档：包含用户故事、验收标准、术语表与需求 ID，让每一项需求都有编号可追。
2. 生成系统设计文档：覆盖架构、组件、数据流、API、部署与测试等章节。
3. 生成实施计划文档：按阶段与任务拆分，标注依赖关系与勾选框，并保持对需求的追溯。
4. 内置多场景模板：为 Web 应用、API、CLI 工具、微服务、数据管道与实时系统提供开箱即用的模板。
5. 可选校验脚本：附带用于生成与校验规划文档的可选脚本，帮助检查文档完整性。
6. 架构预检：可在实现前审查计划，找出缺失组件、不清晰的数据流、薄弱接口、隐藏依赖与不可测试的验收标准。

安装配置

1. 安装技能：执行 npx skillstore add dwsy/project-planner 将技能加入本地技能库。
2. 准备客户端：使用支持技能的 Claude、Codex 或 Claude Code 客户端，并确认工作目录可写。
3. 梳理输入要素：在请求文档前，先准备目标用户、核心功能、部署模型与约束条件，避免生成泛泛而谈的文档。
4. 按需启用脚本：如需自动生成与校验文档，可选择运行附带的脚本，脚本会在本地写出文件。

使用步骤

1. 创建基础计划：让技能规划一个新软件项目，并在信息不足时先追问目标、用户、功能、约束与部署需求。
2. 生成三份核心文档：一次性产出需求、系统设计与实施计划文档，包含可追溯的需求 ID 与任务依赖。
3. 扩展既有计划：新增某项功能时，同步更新需求、设计影响、任务、依赖与验收标准。
4. 实现前评审架构：在动工之前审查计划，找出缺失组件、不清晰的数据流、薄弱接口、隐藏依赖和无法测试的验收标准。
5. 保持三方同步：随着项目变化，持续同步需求 ID、设计组件与任务列表，避免文档与实际脱节。

适用场景

• 启动新软件产品：在写第一行代码前，把产品想法变成需求、架构与分阶段实施计划。
• 为 AI 辅助实现做准备：生成具备追溯性的文档，为 Claude、Codex 或 Claude Code 提供清晰的实现上下文。
• 统一项目文档规范：用可复用的模板统一需求、设计决策、任务拆分与交付跟踪。
• 架构评审前的检查：在关键实现节点前，用计划文档做一次系统性缺口检查。

适用人群

适合技术负责人、产品经理、独立开发者，以及任何需要"先想清楚再动手"的软件团队。对使用 AI 编程工具、又担心 Agent 缺乏上下文而跑偏的人尤其有用。

工作原理

技能通过模板驱动的方式工作：先收集目标、用户、功能与约束，再套用对应场景的模板生成需求、设计与实施三类文档，并在三者之间建立需求 ID 级别的追溯关系。可选脚本负责文档的生成与格式校验，会在本地写入文件。整个过程不涉及网络上传，生成结果仍需由人复核，尤其在受监管或安全关键领域。

注意事项

• 它产出的是规划文档，不是可运行的生产代码。
• 需要使用者提供清晰的目标、用户、功能、约束与技术偏好。
• 生成示例在受监管或安全关键领域使用前必须人工复核。
• 可选脚本会在使用者运行时向本地写入文件。
• 项目目标尚未明确时，不要强求完整计划；也不要跳过验收标准，模糊需求会削弱任务拆分质量。

官方链接

• Skill 详情页：https://skillstore.io/skills/dwsy-project-planner
• 项目仓库：https://github.com/Dwsy/agent