SuperAPI AI 工具集

planning-architect

通用与其它

查看项目

更新于 10-15 10:52

技能介绍

用途

planning-architect 用于系统性地规划 Claude Code 技能开发,把一个初步构想推进到详细的实施蓝图。它的目标是把技能想法转化为可执行的实施计划,包含清晰的结构、合理的估算和已识别的依赖,从而减少返工、缩短开发时间、保持一致性,并产出设计更好的技能。

适用场景

  • 从零开始规划新技能
  • 把现有文档转化为技能
  • 设计复杂的多文件技能
  • 规划技能的改进或重构
  • 协调存在依赖关系的技能开发

规划工作流

该技能引导使用者依次完成六个步骤。

第 1 步:分析需求。 明确技能要解决的问题与范围,包括定义问题、识别目标用户、捕获领域知识、确定范围(明确哪些在范围内、哪些不在范围内、边界是什么、最小可用版本是什么),以及识别现有资源。输出为一份回答上述问题的需求文档。文档中给出了示例场景,如帮助开发者减少调试 Railway 部署的时间。

第 2 步:选择组织模式。 提供四种模式:

  • 基于工作流:适用于顺序明确、步骤间有依赖、有明确终点的过程。结构为 ## Workflow 下的 Step 1、Step 2、Step 3。
  • 基于任务:适用于相互独立、无顺序依赖的操作。结构为 ## Tasks 下的 Task A、Task B、Task C。
  • 参考/指南:适用于标准、模式、设计系统、最佳实践。结构为 ## Guidelines 与 ## Reference。
  • 基于能力:适用于多个互联功能、多个入口、功能可独立或组合使用的复杂系统。结构为 ## Capabilities 与 ## Integration。

技能提供了一套决策流程和模式选择因素对照表(是否顺序重要、依赖关系、快速查阅、标准/指南、多特性、集成复杂度)。输出为所选模式及理由。

第 3 步:规划文件结构。 采用渐进式披露架构,核心原则是保持 SKILL.md 精简,把细节放到 references/ 中。分为三层:

  • SKILL.md(始终加载):目标低于约 5000 词(约 1000-1500 行),包含概览、快速开始、关键工作流、核心概念。
  • references/(按需加载):单文件可超过 10000 词,包含综合指南、详细说明和大量示例。
  • scripts/(执行时加载):自动化辅助、校验工具、生成器。
  • templates/(按需加载):可复用模式、样板代码、脚手架。

该步骤给出完整的目录结构示例,并说明 SKILL.md 应包含什么、哪些内容应移入 references/、scripts/、templates/。还规定了参考文件的命名(描述性连字符命名)、组织策略(按主题、按深度、按工作流步骤、按用例)以及链接写法(使用相对路径和描述性链接文字)。输出为完整的文件结构计划。

第 4 步:估算复杂度。 从技能规模、模式复杂度、领域复杂度、自动化需求、研究需求五个因素进行估算,并给出估算公式:总估算 =(基础时间 × 模式乘数 × 领域乘数)+ 自动化增量 + 研究增量。技能给出三个估算示例和一份估算检查清单,输出为带组成部分分解的时间估算。

第 5 步:识别依赖。 识别五类依赖:技能依赖、工具依赖、知识依赖、文件依赖、反向依赖(哪些技能会依赖本技能)。每一类都给出识别问题与示例。

限制与前提

资料中列出的前提条件包括:问题定义、领域知识、用户背景、现有资源,以及对 skill-builder-generic 模式的熟悉。资料在“第 5 步”示例处中断,后续步骤(如资料描述的前言所述应有六个步骤,但此处仅展开到第 5 步内容)暂未提供完整信息。

暂未提供的信息

该技能的收费标准、价格、支持平台、具体运行环境要求、安装步骤等暂未提供。