# 规划建筑师 ## 概述 Planning-architect从最初的概念到详细的实施蓝图，系统地规划了Claude Code技能的发展。它引导您完成六个连续步骤来创建全面的技能计划，以确保成功的发展。 **目的**：将技能想法转化为具有清晰结构、准确估计和已确定依赖性的可操作实施计划。 **价值**：防止返工，减少开发时间，确保一致性，并通过系统规划产生更好设计的技能。 **何时使用**： * 从头开始规划新技能 * 将现有文档转化为技能 * 构建复杂的多文件技能 * 规划技能改进或重构 * 协调相关技能的发展 ## 先决条件在计划技能之前，收集： 1. **问题定义**：清楚地了解该技能解决什么问题 2. **领域知识**：熟悉所捕获的领域 3. **用户背景**：了解谁将使用该技能以及如何使用该技能 4. **现有资源**：任何可供参考的文档、示例或模式 5. **技能构建者背景**：熟悉技能构建者通用模式 ## 规划工作流程 ### 第 1 步：分析需求 **目标**：明确定义技能必须完成的任务及其范围 **流程**： 1. **定义问题** * 该技能解决什么具体问题？ * 它解决了什么痛点？ * 如果没有这个技能会怎样？ 2. **确定目标用户** * 谁会使用这个技能？（您、团队、社区） * 他们的专业水平如何？ * 他们会在什么上下文中调用它？ 3. **获取领域知识** * 必须掌握哪些领域的专业知识？ * 哪些工作流程需要文档？ * 应包括哪些最佳实践？ * 应避免哪些反模式？ 4. **确定范围** * 范围内明确的内容是什么？ * 什么是明确超出范围的？ * 界限是什么？ * 最低可行技能是什么？ 5. **确定现有资源** * 有类似的技巧可以参考吗？ * 是否有现有文档可供转换？ * 是否有可遵循的社区模式？ * 是否有需要避免的反模式？ **要回答的问题**：问题定义： - 这个技能解决什么问题？ - 谁遇到过这个问题？ - 他们目前如何解决这个问题（如果有的话）？ - 成功是什么样的？范围： - 主要目标是什么？ - 什么是次要目标？ - 什么是明确超出范围的？ - 最低可行版本是什么？用户： - 谁会使用这个技能？ - 他们的专业水平如何？ - 他们会在什么情况下调用它？ - 他们可能还拥有哪些其他技能？域名： - 需要哪些领域知识？ - 该领域存在哪些工作流程？ - 什么术语是标准的？ - 常见的陷阱有哪些？资源： - 有类似的技能需要学习吗？ - 有转换文件吗？ - 有可以效仿的例子吗？ - 需要什么研究？ **输出**：回答上述所有问题的需求文档 **示例**：问题：开发人员浪费时间调试铁路部署用户：具有 Node.js 经验的开发团队领域：铁路部署、Docker、环境配置范围：Node.js + React 的铁路特定部署工作流程超出范围：其他平台（Vercel、AWS）、其他语言资源：铁路文档、现有部署说明 MVP：具有常见故障排除的基本部署工作流程 **另请参阅**：[references/pattern-selection-guide.md]() 包括需求分析模板 ** ** ### 第2步：选择组织模式 **目标**：选择该技能的最佳组织模式 **四种组织模式**： #### 模式 1：基于工作流 **使用时间**：顺序流程，具有明确的步骤，其中顺序很重要 **特点**： * 线性进展（步骤 1 → 步骤 2 → 步骤 3） * 每个步骤都建立在之前的步骤之上 * 明确的起点和终点 * 步骤之间的依赖关系 **示例**： * 部署工作流程 * API集成流程 * 测试工作流程 * 设置/配置序列 **结构**： ## 工作流程 ### 第 1 步：[行动] ### 第 2 步：[行动] ### 步骤 3：[行动] **选择此时间**： * 流程有清晰的顺序步骤 * 操作顺序很重要 * 步骤具有依赖性 * 最后有一个明确的目标 ** ** #### 模式 2：基于任务 **Use When** ：独立操作，无顺序依赖性 **特点**： * 任务可以按任意顺序执行 * 任务之间没有依赖关系 * 快速参考格式 * 每个任务都是独立的 **示例**： * 故障排除指南 * 实用程序集合 * 命令参考 * 独立运营 **结构**： ## 任务 ### 任务A：[行动] ### 任务 B：[行动] ### 任务 C：[行动] **选择此时间**： * 操作独立 * 顺序并不重要 * 用户将执行任务的子集 * 快速查找是主要用例 ** ** #### 模式 3：参考/指南 **使用时间**：标准、模式、设计系统、最佳实践 **特点**： * 参考资料（查找） * 指南和标准 * 全面覆盖 * 示例和规格 **示例**： * 设计系统 * 编码标准 * API文档 * 风格指南 **结构**： ## 指南 ### 准则 1：[概念] ### 准则 2：[概念] ## 参考 ### 成分 A ### 成分 B **选择此时间**： * 记录标准或模式 * 创建参考资料 * 制定指导方针 * 需要全面覆盖 ** ** #### 模式 4：基于能力 **使用时间**：具有多个入口点的集成功能套件 **特点**： * 多种相互关联的功能 * 各种入口点 * 功能协同工作 * 复杂的集成 **示例**： * 复杂系统 * 具有多种功能的平台 * 具有相关功能的工具包 **结构**： ## 能力 ### 能力A：[特征] ### 能力B：[特征] ## 整合各种能力如何协同工作 **选择此时间**： * 多项相关功能 * 功能可以单独使用，也可以一起使用 * 多个有效起点 * 具有多种功能的复杂系统 ** ** **决策过程**：开始 ↓ 该技能是否描述了一个连续的过程？ ├─ 是→顺序重要吗？ │ ├─ 是 → 基于工作流程 │ └─ 否 → 基于任务 │ └─ 否 → 主要是参考资料吗？ ├─ 是 → 参考/指南 └─ 否 → 是否具有多种集成功能？ ├─ 是 → 基于能力 └─ 否 → 重新审查要求（可能是基于任务的） **模式选择因素**：因素 |工作流程|任务|参考|能力 ---|---|---|---|--- 订单事宜 | ✓ | ✗ | ✗ | ～依赖关系 | ✓ | ✗ | ✗ | ✓ 快速查找 | ✗ | ✓ | ✓ | ～顺序过程| ✓ | ✗ | ✗ | ～标准/指南| ✗ | ✗ | ✓ | ✗ 多种功能| 〜| ✗ | ✗ | ✓ 集成复杂度 | 〜| ✗ | ✗ | ✓ **输出**：选定的组织模式及其理由 **示例**：模式：基于工作流理由：铁路部署是顺序的（准备→配置→部署→验证）考虑的替代方案：基于任务的拒绝，因为顺序很重要 **另请参阅**：[references/pattern-selection-guide.md]() 了解全面的决策树和示例 ** ** ### 步骤 3：规划文件结构 **目标**：使用渐进式披露定义完整的文件结构 **渐进式披露架构**：关键原则：**保持 SKILL.md 的精简，在参考文献/**中捆绑详细信息 **三级系统**： 1. **SKILL.md**（始终加载） * 目标：<5,000 字（~1,000-1,500 行） * 内容：概述、快速入门、关键工作流程、核心概念 * 目的：提供必要的上下文而不压倒克劳德的上下文窗口 2. **参考文献/**（按需加载） * 目标：每个文件 10,000+ 字即可 * 内容：全面的指南、详细的解释、广泛的示例 * 目的：在需要时提供深入的细节，而不会使主要技能臃肿 3. **scripts/**（执行时加载） * 目标：任何尺寸 * 内容：自动化助手、验证工具、生成器 * 目的：扩展技能能力的可执行工具 4. **模板/**（需要时加载） * 目标：任何尺寸 * 内容：可重用模式、样板代码、脚手架 * 目的：常见模式的起点 **文件结构规划**：技能名称/ ├── 技能.md（必填） │ ├── YAML frontmatter │ ├── 概述 │ ├── 先决条件（如果需要） │ ├── 主要内容（工作流程/任务/指南/能力） │ ├── 快速入门 │ ├── 范例（简述） │ └── 参考文献（参考文献链接/） │ ├── 参考文献/（可选但推荐） │ ├──Detailed-guide-1.md（综合指南） │ ├──Detailed-guide-2.md（另一个详细指南） │ └── Advanced-topics.md（深入内容） │ ├── 脚本/（可选） │ ├── helper-script.py (自动化) │ └──validation-script.py（验证） │ └── 模板/（可选） ├── template-1.md（可重用模式） └── template-2.md（另一种模式） **SKILL.md内容分配**： **包含在 SKILL.md** 中： * 问题概述（为什么存在技能） * 先决条件 * 核心工作流程/任务/指南/功能 * 快速入门说明 * 简要示例（1-3） * 详细参考资料链接 **移至参考文献/**： * 全面的分步指南 * 丰富的示例 (4+) * 详细解释 * 高级主题 * 故障排除指南 * 深入探讨概念 * 长参考表 **移至脚本/**： * 自动化助手 * 验证工具 * 代码生成器 * 分析工具 * 交互式向导 **移至模板/**： * 样板文件 * 配置模板 * 代码支架 * 可重复使用的图案 **参考文件命名**：使用描述性连字符名称： * `pattern-selection-guide.md` （不是 `guide1.md`） * `complexity-estimation-techniques.md` （不是 `complexity.md`） * `advanced-workflows.md` （不是 `advanced.md`） **参考组织策略**： 1. **按主题**（最常见）参考文献/ ├── 认证指南.md ├── 数据获取指南.md └── 错误处理指南.md 2. **按深度**（渐进式学习）参考文献/ ├── 基础指南.md ├── 中级指南.md └── 高级指南.md 3. **按工作流程步骤**（对于基于工作流程）参考文献/ ├── 步骤1-准备指南.md ├── 步骤2-执行指南.md └── 步骤3-验证-指南.md 4. **按用例**（对于基于任务）参考文献/ ├── use-case-api-integration.md ├── 用例数据库设置.md └── 用例测试.md **链接到参考文献**：始终使用带有描述性链接文本的相对路径：好：详细决策树请参见[模式选择指南](references/pattern-selection-guide.md)。坏：有关详细信息，请参阅references/pattern-selection-guide.md。 **输出**：完整的文件结构计划，包括文件名和内容分配 **示例**：铁路部署/ ├── SKILL.md（~1,200 行） │ - 铁路部署概览 │ - 先决条件 │ - 4步部署工作流程 │ - 快速入门示例 │ - 参考文献链接 │ ├── 参考资料/ │ ├── 环境配置指南.md (~800行) │ ├── docker-setup-guide.md (~600行) │ ├── Troubleshooting-common-issues.md (~1,000 行) │ └── Railway-pricing-optimization.md (~400条线路) │ ├── 脚本/ │ └── validate-config.py (~150 行) │ └── 模板/ └──railway-config-template.json（~50行） **另请参阅**：[references/structural-planning-guide.md]() 用于全面的渐进式披露规划 ** ** ### 步骤 4：估计复杂性 **目标**：估计所需的开发时间和精力 **复杂性因素**： 1. **技能规模** * 最短（仅限 SKILL.md）：2-4 小时 * 小（SKILL.md + 1-2 参考文献）：6-10 小时 * 中等（SKILL.md + 3-5 篇参考文献）：12-18 小时 * 大型（SKILL.md + 6+ 参考文献 + 脚本）：20-30 小时 * 非常大（多个脚本、模板、大量文档）：30 多个小时 2. **模式复杂性** * 基于工作流程：中（需要清楚地记录每个步骤） * 基于任务：低-中（独立任务更容易记录） * 参考/指南：中高（需要全面覆盖） * 基于能力：高（与文档的复杂交互） 3. **领域复杂性** * 熟悉的领域：1x 乘数 * 需要一些学习：1.5 倍乘数 * 需要大量研究：2 倍乘数 * 新颖/复杂的领域：2.5x+ 乘数 4. **自动化要求** * 无脚本：0 额外小时 * 简单脚本（1-2）：+4-6小时 * 复杂脚本 (3+)：+10-15 小时 * 互动工具：+15-20小时 5. **研究要求** * 现有文档：1x * 需要一些研究：+2-4 小时 * 广泛的研究：+8-12小时 * 没有现有资源：+15+小时 **估算公式**：基本时间 = 技能规模（来自因素 1）模式乘数 = 因子 2 域乘数 = 因子 3 自动化添加 = 因素 4 研究添加 = 因子 5 总估算 =（基准时间 × 模式乘数 × 域乘数）+ 自动化添加 + 研究添加 **估计示例**： **示例1：简单的故障排除技巧** 基地：小型（6-10小时）= 8小时模式：基于任务 (1x) 领域：熟悉 (1x) 自动化：无（0h）研究：现有文档 (0h) 合计：8小时×1×1+0+0=8小时 **示例 2：复杂的部署工作流程** 基地：大（20-30小时）= 25小时模式：基于工作流（1.2x）领域：一些学习 (1.5x) 自动化：简单脚本（5 小时）研究：需要一些（3小时）合计：25小时×1.2×1.5+5+3=53小时 **示例 3：设计系统参考** 基础：中等（12-18小时）= 15小时模式：参考/指南 (1.3x) 领域：熟悉 (1x) 自动化：无（0h）研究：现有文档 (0h) 合计：15小时×1.3×1+0+0=19.5小时 **估算清单**： * 计算所需参考文件的数量 * 评估领域知识差距 * 确定的自动化需求 * 确定的研究要求 * 应用模式复杂度乘数 * 添加了迭代缓冲区 (10-20%) * 经验证的估计似乎是合理的 **输出**：按组件细分的时间估计 **示例**：预计开发时间：42-48 小时细分： - 技能.md：8小时 - 参考文献/（4 个文件）：20 小时 - 模式选择指南.md：6小时 - 结构规划指南.md：6小时 - 复杂性估计指南.md：4小时 - 依赖分析指南.md：4小时 - 脚本/plan-skill.py：10小时 - 模板/：2小时 - 验证和测试：4 小时总计：44 小时（42-48 小时范围） **另请参阅**：[references/complexity-estimation-guide.md]() 了解详细的估计技术和校准数据 ** ** ### 步骤 5：确定依赖关系 **目标**：确定该技能取决于什么以及什么取决于它 **依赖类型**： #### 1\.技能依赖性该技能所依赖的技能或参考 **识别问题**： * 该技能是否假设存在其他技能？ * 该技能是否参考了示例中的其他技能？ * 该技能与其他可用技能一起使用会更有效吗？ **示例**：规划架构师取决于： - 技能构建器通用（用于技能模式） - 没有硬依赖性，但通过以下方式增强： - 任务开发（用于分解实施） - 复杂性估计（用于时间估计） #### 2\.工具依赖此技能需要外部工具或 MCP **识别问题**： * 该技能是否使用特定的克劳德代码工具？（WebSearch、WebFetch、Bash 等） * 该技能需要 MCP 吗？（Context7、GitHub 等） * 是否需要外部服务？（API、数据库等） **示例**：技能研究员取决于： - 网络搜索工具（最新模式） - WebFetch 工具（用于文档） - Context7 MCP（可选，用于深层上下文） - GitHub API（用于社区技能分析） #### 3\.知识依赖性用户必须具备的领域知识或先决条件 **识别问题**： * 用户在使用该技能之前必须具备哪些知识？ * 用户必须理解哪些术语？ * 哪些概念被假定为已知？ **示例**：铁路部署要求用户了解： - 基本 Node.js 和 npm - Git 基础知识 - 命令行使用 - HTTP 概念（用于 API 部署） #### 4\.文件依赖关系此技能引用的项目中的文件 **识别问题**： * 该技能是否引用特定文件路径？ * 是否采用特定的项目结构？ * 它期望配置文件存在吗？ **示例**：部署指南假设： - package.json 存在 - .env.example 存在（对于环境变量） - Dockerfile存在（或提供模板） #### 5\.反向依赖（依赖什么）取决于该技能的其他技能 **识别问题**： * 在这之后将培养哪些技能？ * 哪些技能可以参考该技能？ * 下游消费者是谁？ **示例**：规划建筑师将取决于： - 任务开发（使用计划输出） - 技能研究员（纳入规划） - 所有未来的技能发展（规划是第一步） **依赖文档格式**： ## 依赖关系 ### 必填 - 技能构建器通用：核心模式和模板 - 网络搜索工具：用于研究类似技能 ### 可选 - Context7 MCP：增强复杂规划的背景 - 技能研究员：用于综合研究阶段 ### 用户先决条件 - 熟悉通用技能构建器 - 对渐进式披露的理解 - 基础Markdown知识 ### 反向依赖 - 任务开发（将使用计划输出） - 技能编写器（用于多技能工作流程） **输出**：包含所有五种类型的完整依赖项列表 **示例**：规划架构师的依赖关系：技能依赖： - 必需：技能构建者通用 - 可选：技能研究员、分析工具依赖： - 无（仅使用标准克劳德代码功能）知识依赖性： - 熟悉Claude Code技能 - 对渐进式披露的理解 - Markdown知识文件依赖关系： - Skill-builder-package/examples/*（参考示例）反向依赖： - 任务开发（引导序列中的下一个） - 待办事项管理（使用计划结构） - 所有未来技能（规划是基础） **另请参阅**：[references/dependency-analysis-guide.md]() 用于依赖关系映射技术 ** ** ### 第 6 步：定义验证标准 **目标**：建立如何验证技能是否正常工作 **验证类别**： #### 1\.结构验证该技能的文件结构是否正确？ **标准**： * SKILL.md 存在且具有有效的 YAML frontmatter * 目录结构符合计划 * 所有参考文件均存在 * 所有脚本均可执行 * 所有模板均存在 **验证方法**：运行 `validate-skill.py` 脚本 ** ** #### 2\.内容验证内容是否完整、正确？ **标准**： * 概述清楚地说明了目的 * 先决条件已记录 * 主要内容遵循所选模式 * 提供示例 * 参考文献链接正确 * 写作时使用祈使语气 * 没有 TODO 占位符（模板中除外） * 描述中出现的触发关键字 **验证方式**：人工审核+自动检查 ** ** #### 3\.功能验证技能真的有用吗？ **标准**： * 可以通过名称调用技能 * 技能加载无错误 * 根据要求加载参考文献 * 脚本执行成功 * 可以使用模板 * 示例产生预期结果 **验证方式**：测试调用+脚本执行 ** ** #### 4\.可用性验证技能好用吗？ **标准**： * 快速启动实际上很快（<5 分钟） * 示例清晰且相关 * 指示明确 * 术语一致 * 导航直观 * 上下文窗口影响最小 **验证方法**：用户测试+反馈 ** ** #### 5\.完整性验证该技能是否涵盖了应有的一切？ **标准**： * 满足第 1 步中的所有要求 * 所有工作流程均已记录 * 涵盖边缘情况 * 包含故障排除 * 捕捉最佳实践 * 注意到反模式 **验证方法**：需求可追溯性矩阵 ** ** **验证计划模板**： ## 验证计划 ### 结构验证方法：自动化脚本工具：validate-skill.py 通过标准：零错误，最多 1 次警告 ### 内容验证方式：人工审核检查表：50 点验证检查表通过标准：所有清单项目均通过 ### 功能验证方法：测试调用测试用例： 1. 在 clean 会话中调用技能 2. 索取参考文件 3. 使用测试输入执行脚本 4. 在示例项目中使用模板通过标准：所有测试用例均成功 ### 可用性验证方法：用户测试测试人员：2-3 名开发人员通过标准：用户可以在<5分钟内完成快速启动 ### 完整性验证方法：需求审查流程：检查每个需求是否有对应的内容通过标准：100% 要求覆盖率 **输出**：带有测试用例的综合验证计划 **示例**：规划建筑师的验证计划：结构： - 运行 validate-skill.py - 验证 4 个参考文件是否存在 - 验证 plan-skill.py 可执行内容： - 查看所有 6 个工作流程步骤 - 验证每个步骤中的示例 - 检查命令式语音使用情况 - 验证触发关键字功能性： - 调用规划建筑师 - 遵循测试技能的工作流程 - 使用测试输入运行 plan-skill.py - 验证生成完整的计划可用性： - 要求开发者规划简单的技巧 - 快速启动完成时间 - 收集有关清晰度的反馈完整性： - 验证涵盖的所有规划方面 - 检查记录的所有 4 个模式 - 确保存在估算方法 - 验证包括依赖性分析 ** ** ## 快速入门：30 分钟内规划一项技能 ### 1\.分析需求（10 分钟）回答这些问题： * **问题**：该技能解决什么问题？ * **用户**：谁会使用它？ * **领域**：要捕获哪些知识？ * **范围**：什么在范围之内/之外？ ### 2\.选择模式（5 分钟）使用决策树： * 具有依赖性的顺序过程？ → **基于工作流程** * 独立运营？ → **基于任务** * 标准/参考？ → **参考/指南** * 多种集成功能？ → **基于能力** ### 3\.计划结构（5 分钟）技能名称/ ├── SKILL.md（总是） ├──参考文献/（如果需要详细指南） ├── 脚本/（如果需要自动化） └── templates/ (如果需要可重用的模式) ### 4\.预计时间（5分钟） * 参考文件数量：____ * 需要自动化吗？：____ * 需要研究吗？：____ * 粗略估计：____小时 ### 5\.列出依赖项（3 分钟） * 技能依赖性：____ * 工具依赖：____ * 知识先决条件：____ ### 6\.定义验证（2 分钟） * 结构：validate-skill.py * 功能：测试调用+脚本 * 完整：需求覆盖范围 **结果**：完整的计划可供实施！ ** ** ## 示例 ### 示例1：简单的故障排除技巧 **要求**： * 问题：铁路部署错误是神秘的 * 用户：具有铁路经验的开发团队 * 领域：铁路故障排除 * 范围：常见错误+解决方案 **模式**：基于任务（独立的错误情况） **结构**：铁路故障排除/ ├── SKILL.md（基于任务的格式） └── 参考资料/ └── 高级故障排除.md **估计**：8-10 小时（小而熟悉的领域） **依赖关系**： * 知识：铁路基本概念 * 无技能依赖性 **验证**：测试每个故障排除案例 ** ** ### 示例 2：复杂的 API 集成 **要求**： * 问题：FHIR API 集成复杂 * 用户：医疗开发团队 * 域：FHIR、OAuth、REST * 范围：完整的集成工作流程 **模式**：基于工作流（顺序集成步骤） **结构**： fhir-集成/ ├── SKILL.md（工作流程格式） ├── 参考资料/ │ ├── fhir-resources-guide.md │ ├── oauth-setup-guide.md │ └── 错误处理指南.md ├── 脚本/ │ └── validate-fhir-response.py └── 模板/ └── fhir-request-template.json **估计**：35-40 小时（时间较长，需要进行一些研究） **依赖关系**： * 技能：oauth-集成 * 工具：WebFetch（用于API测试） * 知识：REST API、JSON **验证**：与 FHIR 服务器的全面集成测试 ** ** ### 示例 3：设计系统参考 **要求**： * 问题：UI组件不一致 * 用户：前端团队 * 领域：设计系统 * 范围：颜色、排版、组件 **模式**：参考/指南（设计标准） **结构**：设计系统/ ├── SKILL.md（参考格式） ├── 参考资料/ │ ├── 调色板指南.md │ ├── 版式指南.md │ └── 组件库.md └── 资产/ ├── 颜色.png └── 版式示例.png **估计**：18-22 小时（中等，设计领域） **依赖关系**： * 知识：设计原理、CSS * 无技能依赖性 **验证**：将设计系统应用于示例组件 ** ** ## 规划输出完成 6 步工作流程后，您应该： 1. **需求文件** * 问题陈述 * 用户资料 * 领域知识范围 * 明确的范围边界 * 资源库存 2. **模式选择** * 选择的模式有理由 * 拒绝的模式并说明原因 3. **文件结构规划** * 完整的目录树 * 所有文件的文件名 * 内容分配（什么到哪里） * 渐进式披露策略 4. **时间预估** * 总体估计范围 * 按组件细分 * 应用的复杂性因素 * 包括缓冲器 5. **依赖关系图** * 技能依赖性（必需+可选） * 工具依赖 * 知识先决条件 * 反向依赖 6. **验证计划** * 结构验证方法 * 内容验证清单 * 功能测试用例 * 可用性测试方法 * 完整性标准 **格式** ：请参阅 [templates/skill-plan-template.md]() 了解结构化输出格式 ** ** ## 最佳实践 ### 规划最佳实践 1. **从为什么开始** * 清楚地阐明问题 * 在规划之前验证需求 * 考虑技能是否是正确的解决方案 2. **谨慎选择图案** * 模式驱动整个结构 * 考虑用户心理模型 * 通过示例验证模式 3. **进化计划** * 技能会随着时间的推移而增长 * 结构应容纳附加内容 * 为未来的改进留出空间 4. **优化上下文使用** * 保持 SKILL.md 的精益 * 将详细信息移至参考文献 * 每个单词都需要上下文标记 5. **尽早验证** * 实施前审查计划 * 获取潜在用户的反馈 * 根据反馈进行调整 ### 常见的规划错误 1. **范围蔓延** * 问题：一次计划太多 * 解决方案：定义MVP，计划迭代 2. **错误的模式** * 问题：为独立任务选择工作流程 * 解决方案：谨慎使用决策树 3. **渐进式披露不佳** * 问题：将所有内容放入 SKILL.md * 解决方案：遵循 <5,000 字指南 4. **低估复杂性** * 问题：时间估计不切实际 * 解决办法：使用配方，添加缓冲液 5. **忽略依赖关系** * 问题：缺少必备技能 * 解决方案：完整的依赖分析 ** ** ## 参考文献每个规划步骤的综合指南： * **[模式选择指南]()** \- 完整的决策树，其中包含用于在工作流、任务、参考和功能模式之间进行选择的详细示例。包括边缘情况和组合模式。 * **[结构规划指南]()** \- 深入探讨渐进式披露、文件组织策略、内容分配技术和上下文优化方法。 * **[复杂度估算指南]()** \- 详细的估算技术、来自真实技能的校准数据、估算工作表和准确性改进方法。 * **[依赖分析指南]()** \ - 全面的依赖识别技术、依赖映射策略、循环依赖解析和版本管理。 ** ** ## 自动化使用规划自动化脚本进行指导规划： # 交互式规划向导 python 脚本/plan-skill.py --interactive # 根据描述文件进行规划 python 脚本/plan-skill.py --description Skill-description.txt # 生成具有特定模式的计划 python 脚本/plan-skill.py --模式工作流程 --name my-skill # 输出计划到文件 python 脚本/plan-skill.py --interactive --output Skill-plan.md 有关所有选项，请参阅脚本帮助： python 脚本/plan-skill.py --help ** ** ## 成功标准成功的技能计划包括： ✅ **明确的要求** * 问题表述清楚 * 用户已识别 * 明确定义范围 * 资源盘点 ✅ **合理的模式选择** * 选择具有清晰推理的模式 * 考虑并拒绝的替代方案 * 模式适合用户心理模型 ✅ **完整的结构计划** * 识别出的所有文件 * 内容分配适当 * 渐进式披露优化 * 命名遵循约定 ✅ **实际估计** * 按组件细分 * 应用的复杂性因素 * 提供范围（不是单个数字） * 包括缓冲器 ✅ **全面的依赖关系** * 涵盖所有依赖类型 * 记录先决条件 * 识别反向依赖关系 ✅ **验证策略** * 多种验证类型 * 明确的通过/失败标准 * 定义测试用例 * 验证计划是可行的 ** ** ## 后续步骤完成技能规划后： 1. **审查计划** * 验证完整性 * 获得团队技能反馈 * 根据反馈进行调整 2. **继续实施** * 使用skill-builder-generic来实现 * 遵循计划中的文件结构 * 时间管理的参考估算 3. **跟踪进度** * 使用任务开发来分解实施 * 使用待办事项管理来跟踪进度 * 如果出现重大偏差，调整计划 4. **持续验证** * 经常运行验证 * 在构建时进行测试 * 根据发现进行迭代 ** ** ## 快速参考 ### 6 步规划流程步骤|焦点 |关键输出|时间 ---|---|---|--- 1\.分析需求|问题、用户、范围、域 |需求文件| 30-60m 2\.选择图案 |工作流程/任务/参考/功能 |模式选择与理由| 15-30m 3\.设计结构|文件、部分、渐进式披露 |文件结构图 | 30-45m 4\.计划内容|逐节内容大纲|内容计划| 45-90m 5\.估计复杂性 |时间、依赖性、风险 |工作量估算 | 20-30m 6\.创建计划文件|综合实施计划|完整的技能计划| 30-45m **总规划时间**：综合规划3-5小时 ### 4 种组织模式图案|何时使用 |结构|示例 ---|---|---|--- **工作流程** |顺序依赖，有步骤的过程 |编号步骤（步骤 1→2→3）|部署指南、开发工作流程 **任务** |独立运营，无需下单 |未编号的操作 |铁路故障排除、多审查 **参考** |标准、指南、设计系统 |基于主题的部分 |植物设计、常见模式 **能力** |多个相关功能一起使用|综合能力|复杂的多功能技能 ### 模式选择决策树步骤是否具有顺序依赖性？ ├─ 是 → 工作流程（使用编号步骤） └─ 否 → 运营是否独立？ ├─ 是 → 任务（使用未编号的操作） └─ 否 → 是标准/指南吗？ ├─ 是 → 参考（基于主题的组织） └─ 否 → CAPABILITIES（集成功能） ### 复杂性估计指南复杂性 |文件 |线路 |时间 |特点 ---|---|---|---|--- **简单** | 1-3 | 1-3 400-800 | 2-4小时|单个文件或最少引用 **中** | 4-8 | 1,500-3,000 | 8-15小时|多个参考，也许是脚本 **复杂** | 9-15+ | 3,000-5,000+ | 20-40小时|广泛的参考资料、自动化脚本 ### 渐进披露规则 * **SKILL.md** ：<1,200 行理想（概述 + 要点） * **参考文献/** ：每个文件 300-600 行（详细指南） * **scripts/** ：自动化工具（需要时加载） **决定**：如果内容>1,000行→将详细内容移至参考文献/ ### 共同规划输出 **需求文件**： * 问题定义 * 用户分析 * 范围边界 * 领域知识捕获 **结构计划**： * 文件组织 * 章节概要 * 渐进式披露策略 * 命名约定 **实施计划**： * 完整的逐个文件细分 * 内容规格 * 时间预估 * 确定依赖关系 * 验证标准 ### 快速计划清单 * 明确定义问题（什么、谁、为什么） * 确定的用户（专业水平、背景） * 建立范围边界（范围内/范围外） * 模式选择的合理性 * 文件结构设计 * 内容逐节规划 * 估计的复杂性（简单/中等/复杂） * 确定依赖关系 * 分配的时间预算 * 创建计划文档 ### 了解更多信息 * **需求分析**：参见步骤 1 * **模式选择** ：参见步骤 2 + 参考文献/pattern-selection-guide.md * **结构设计** ：参见步骤3+references/structural-planning-guide.md * **内容规划** ：参见步骤 4 +references/content-specation-guide.md * **复杂性估计**：参见步骤 5 +references/complexity-assessment-guide.md ** ** **规划架构师**是系统技能发展的基础。用它来将想法转化为可操作的实施计划，从而培养高质量、结构良好的克劳德代码技能。

规划建筑师

包含技能