sinapse-ai 5.0.8 → 6.0.0

package/docs/zh/sinapse-agent-flows/squad-creator-system.md

@@ -1,704 +0,0 @@
-<!--
-  翻译：zh-CN（简体中文）
-  原文：/docs/sinapse-agent-flows/squad-creator-system.md
-  最后同步：2026-02-22
--->
-
-# SINAPSE 小队创建和管理系统
-
-> **版本：** 1.0.0
-> **创建日期：** 2026-02-04
-> **负责人：** @squad-creator (Craft)
-> **状态：** 官方文档
-
----
-
-## 概述
-
-**小队创建者** (Craft) 是 SINAPSE 用于创建、验证、发布和管理小队的专业代理。小队是代理、任务、工作流和资源的模块化包，可在项目之间重用。
-
-该系统实现了 SINAPSE 的**任务优先架构**，其中任务是执行的主要入口点，代理编排这些任务。
-
-### 系统目的
-
-- **创建小队**遵循 SINAPSE 模式和结构
-- **验证小队**针对 JSON Schema 和任务规范
-- **列出小队**项目本地
-- **分发小队**在 3 个级别（本地、sinapse-squads、SINAPSE API）
-- **迁移小队**到带编排和技能的 v2 格式
-- **分析和扩展**现有小队
-
-### 基本原则
-
-1. **任务优先架构**：任务是入口点，代理编排
-2. **强制验证**：分发前始终验证
-3. **JSON Schema**：清单针对 schema 验证
-4. **3 级分发**：本地、公共（sinapse-squads）、市场（SINAPSE API）
-5. **与 sinapse-ai 集成**：小队与框架协同工作
-
----
-
-## 完整文件列表
-
-### 代理定义核心文件
-
-| 文件 | 目的 |
-|---------|-----------|
-| `.sinapse-ai/development/agents/squad-creator.md` | 小队创建者代理核心定义 |
-| `.claude/commands/SINAPSE/agents/squad-creator.md` | 用于激活 @squad-creator 的 Claude Code 命令 |
-
-### @squad-creator 任务文件
-
-| 文件 | 命令 | 目的 | 状态 |
-|---------|---------|-----------|--------|
-| `.sinapse-ai/development/tasks/squad-creator-create.md` | `*create-squad` | 创建带完整结构的新小队 | 活跃 |
-| `.sinapse-ai/development/tasks/squad-creator-design.md` | `*design-squad` | 分析文档并生成蓝图 | 活跃 |
-| `.sinapse-ai/development/tasks/squad-creator-validate.md` | `*validate-squad` | 验证小队针对 schema 和模式 | 活跃 |
-| `.sinapse-ai/development/tasks/squad-creator-list.md` | `*list-squads` | 列出本地小队 | 活跃 |
-| `.sinapse-ai/development/tasks/squad-creator-analyze.md` | `*analyze-squad` | 分析结构并建议改进 | 活跃 |
-| `.sinapse-ai/development/tasks/squad-creator-extend.md` | `*extend-squad` | 使用新组件扩展小队 | 活跃 |
-| `.sinapse-ai/development/tasks/squad-creator-migrate.md` | `*migrate-to-v2` | 迁移小队到 v2 格式 | 活跃 |
-| `.sinapse-ai/development/tasks/squad-generate-skills.md` | `*generate-skills` | 生成小队知识技能 | 活跃 |
-| `.sinapse-ai/development/tasks/squad-generate-workflow.md` | `*generate-workflow` | 生成 YAML 编排工作流 | 活跃 |
-| `.sinapse-ai/development/tasks/squad-creator-download.md` | `*download-squad` | 从公共仓库下载小队 | 占位符（Sprint 8） |
-| `.sinapse-ai/development/tasks/squad-creator-publish.md` | `*publish-squad` | 发布小队到 sinapse-squads | 占位符（Sprint 8） |
-| `.sinapse-ai/development/tasks/squad-creator-sync-sinapse.md` | `*sync-squad-sinapse` | 同步小队到 SINAPSE API | 占位符（Sprint 8） |
-
-### 相关任务文件
-
-| 文件 | 命令 | 目的 |
-|---------|---------|-----------|
-| `.sinapse-ai/development/tasks/create-agent.md` | `*create-agent` | 创建单个代理定义 |
-| `.sinapse-ai/development/tasks/create-task.md` | `*create-task` | 创建单个任务文件 |
-| `.sinapse-ai/development/tasks/create-workflow.md` | `*create-workflow` | 创建编排工作流 |
-
-### 支持脚本
-
-| 文件 | 类/函数 | 目的 |
-|---------|---------------|-----------|
-| `.sinapse-ai/development/scripts/squad/squad-generator.js` | `SquadGenerator` | 生成完整小队结构 |
-| `.sinapse-ai/development/scripts/squad/squad-validator.js` | `SquadValidator` | 验证小队针对 schema 和模式 |
-| `.sinapse-ai/development/scripts/squad/squad-loader.js` | `SquadLoader` | 加载和解析小队 |
-| `.sinapse-ai/development/scripts/squad/squad-designer.js` | `SquadDesigner` | 分析文档并生成蓝图 |
-| `.sinapse-ai/development/scripts/squad/squad-analyzer.js` | `SquadAnalyzer` | 分析小队结构 |
-| `.sinapse-ai/development/scripts/squad/squad-extender.js` | `SquadExtender` | 扩展现有小队 |
-| `.sinapse-ai/development/scripts/squad/squad-migrator.js` | `SquadMigrator` | 迁移小队到 v2 |
-| `.sinapse-ai/development/scripts/squad/squad-downloader.js` | `SquadDownloader` | 从仓库下载小队 |
-| `.sinapse-ai/development/scripts/squad/squad-publisher.js` | `SquadPublisher` | 发布小队 |
-
-### JSON Schema
-
-| 文件 | 目的 |
-|---------|-----------|
-| `.sinapse-ai/schemas/squad-schema.json` | squad.yaml 验证 schema |
-| `.sinapse-ai/schemas/squad-design-schema.json` | 蓝图验证 schema |
-
-### 输出文件（生成的小队）
-
-| 目录 | 目的 |
-|-----------|-----------|
-| `./squads/{squad-name}/` | 小队根目录 |
-| `./squads/{squad-name}/squad.yaml` | 小队清单（必需） |
-| `./squads/{squad-name}/README.md` | 小队文档 |
-| `./squads/{squad-name}/agents/` | 代理定义 |
-| `./squads/{squad-name}/tasks/` | 任务定义 |
-| `./squads/{squad-name}/workflows/` | 编排工作流 |
-| `./squads/{squad-name}/config/` | 配置文件 |
-| `./squads/.designs/` | *design-squad 生成的蓝图 |
-
----
-
-## 流程图：小队管理完整系统
-
-```mermaid
-flowchart TB
-    subgraph INPUTS["输入"]
-        DOCS["文档<br/>（PRD、规范）"]
-        USER["用户<br/>（命令）"]
-        EXISTING["现有小队<br/>（验证/扩展）"]
-    end
-
-    DOCS -->|"*design-squad"| BLUEPRINT
-    USER -->|"*create-squad"| CREATE
-    EXISTING -->|"*validate-squad"| VALIDATE
-
-    subgraph DESIGN["设计阶段"]
-        BLUEPRINT["蓝图<br/>.designs/{name}-design.yaml"]
-        ANALYSIS["领域分析<br/>- 实体<br/>- 工作流<br/>- 集成"]
-        RECOMMEND["建议<br/>- 代理<br/>- 任务<br/>- 置信度分数"]
-    end
-
-    DOCS --> ANALYSIS
-    ANALYSIS --> RECOMMEND
-    RECOMMEND --> BLUEPRINT
-
-    subgraph CREATE["创建阶段"]
-        TEMPLATE["模板选择<br/>- basic<br/>- etl<br/>- agent-only"]
-        VERSION["版本选择<br/>- v1（遗留）<br/>- v2（编排）"]
-        GENERATE["生成结构<br/>- squad.yaml<br/>- agents/<br/>- tasks/<br/>- workflows/"]
-    end
-
-    BLUEPRINT -->|"--from-design"| GENERATE
-    TEMPLATE --> GENERATE
-    VERSION --> GENERATE
-
-    subgraph VALIDATE["验证阶段"]
-        SCHEMA["Schema 验证<br/>squad-schema.json"]
-        STRUCTURE["结构检查<br/>- tasks/<br/>- agents/<br/>- 引用的文件"]
-        TASK_FMT["任务格式<br/>TASK-FORMAT-V1"]
-        AGENT_FMT["代理格式<br/>YAML 结构"]
-    end
-
-    GENERATE --> VALIDATE
-    SCHEMA --> RESULT
-    STRUCTURE --> RESULT
-    TASK_FMT --> RESULT
-    AGENT_FMT --> RESULT
-
-    subgraph RESULT["结果"]
-        VALID["有效<br/>（或有警告）"]
-        INVALID["无效<br/>（发现错误）"]
-    end
-
-    subgraph DISTRIBUTE["分发"]
-        LOCAL["本地<br/>./squads/"]
-        PUBLIC["公共<br/>github.com/SinapseAI/sinapse-squads"]
-        MARKET["市场<br/>api.sinapse.ai/squads"]
-    end
-
-    VALID --> LOCAL
-    VALID -->|"*publish-squad"| PUBLIC
-    VALID -->|"*sync-squad-sinapse"| MARKET
-
-    style INPUTS fill:#e1f5fe
-    style DESIGN fill:#fff3e0
-    style CREATE fill:#e8f5e9
-    style VALIDATE fill:#fce4ec
-    style RESULT fill:#f3e5f5
-    style DISTRIBUTE fill:#e0f7fa
-    style VALID fill:#c8e6c9
-    style INVALID fill:#ffcdd2
-```
-
----
-
-## 流程图：v1 vs v2 模板的小队创建
-
-```mermaid
-flowchart TB
-    START["*create-squad {name}"]
-
-    START --> VERSION{"模板版本？"}
-
-    VERSION -->|"v2（默认）"| V2_PATH
-    VERSION -->|"v1（--legacy）"| V1_PATH
-
-    subgraph V2_PATH["v2 - 编排 + 技能"]
-        V2_YAML["squad.yaml v2<br/>- 编排配置<br/>- 技能配置<br/>- 元数据"]
-        V2_WF["workflows/main-workflow.yaml<br/>- 阶段定义<br/>- 错误处理<br/>- 超时配置"]
-        V2_AGENT["agents/ with skill_dispatch<br/>- auto_inject 技能"]
-    end
-
-    subgraph V1_PATH["v1 - 遗留结构"]
-        V1_YAML["squad.yaml v1<br/>- 基本清单<br/>- 组件列表"]
-        V1_EMPTY["空 workflows/<br/>（无编排）"]
-        V1_AGENT["agents/ 基本<br/>（无技能）"]
-    end
-
-    V2_PATH --> COMMON
-    V1_PATH --> COMMON
-
-    subgraph COMMON["通用结构"]
-        CONFIG["config/<br/>- coding-standards.md<br/>- tech-stack.md<br/>- source-tree.md"]
-        TASKS["tasks/<br/>- example-task.md"]
-        DIRS["空目录：<br/>checklists/<br/>templates/<br/>tools/<br/>scripts/<br/>data/"]
-    end
-
-    COMMON --> VALIDATE["*validate-squad"]
-    VALIDATE --> DONE["小队就绪"]
-
-    style V2_PATH fill:#e8f5e9
-    style V1_PATH fill:#fff3e0
-    style COMMON fill:#e1f5fe
-```
-
----
-
-## 流程图：带蓝图的设计流程
-
-```mermaid
-flowchart TB
-    subgraph INPUT["输入阶段"]
-        DOCS["文档文件<br/>- PRD<br/>- 规范<br/>- 需求"]
-        VERBAL["口头描述<br/>（交互式）"]
-        DOMAIN["领域提示<br/>--domain 标志"]
-    end
-
-    INPUT --> NORMALIZE["1. 输入规范化<br/>- 解析 markdown/yaml/json<br/>- 提取文本内容<br/>- 合并来源"]
-
-    NORMALIZE --> ANALYZE["2. 领域分析"]
-
-    subgraph ANALYZE["分析管道"]
-        ENTITY["实体提取<br/>- 名词/专有名词<br/>- 领域术语<br/>- 组概念"]
-        WORKFLOW["工作流检测<br/>- 动作动词<br/>- 顺序流程<br/>- I/O 模式"]
-        INTEGRATION["集成映射<br/>- 外部系统<br/>- API/服务"]
-        STAKE["利益相关者 ID<br/>- 用户角色<br/>- 人物画像"]
-    end
-
-    ANALYZE --> RECOMMEND["3. 建议引擎"]
-
-    subgraph RECOMMEND["建议"]
-        AGENTS["代理生成<br/>- 工作流角色<br/>- 步骤命令<br/>- 置信度计算"]
-        TASKS_R["任务生成<br/>- TASK-FORMAT-V1<br/>- 输入的 Entrada<br/>- 输出的 Saida"]
-        DEDUP["去重<br/>- 合并 >70% 重叠"]
-    end
-
-    RECOMMEND --> REVIEW["4. 交互审查"]
-
-    subgraph REVIEW["用户细化"]
-        CONFIRM["[A]接受代理"]
-        MODIFY["[M]修改代理"]
-        REJECT["[R]拒绝代理"]
-        ADD["[A]添加自定义"]
-    end
-
-    REVIEW --> BLUEPRINT["蓝图输出<br/>.designs/{name}-design.yaml"]
-
-    BLUEPRINT --> CREATE["*create-squad --from-design"]
-
-    style INPUT fill:#e1f5fe
-    style ANALYZE fill:#fff3e0
-    style RECOMMEND fill:#e8f5e9
-    style REVIEW fill:#fce4ec
-```
-
----
-
-## 流程图：验证管道
-
-```mermaid
-flowchart TB
-    START["*validate-squad {name}"]
-
-    START --> RESOLVE["1. 解析小队路径<br/>./squads/{name}/ 或完整路径"]
-
-    RESOLVE --> MANIFEST["2. 清单验证"]
-
-    subgraph MANIFEST["清单检查"]
-        FIND["查找清单<br/>squad.yaml 或 config.yaml"]
-        PARSE["解析 YAML"]
-        SCHEMA["验证 vs JSON Schema<br/>- name（kebab-case）<br/>- version（semver）<br/>- components"]
-    end
-
-    MANIFEST --> STRUCTURE["3. 结构验证"]
-
-    subgraph STRUCTURE["结构检查"]
-        DIRS["检查目录<br/>- tasks/（必需）<br/>- agents/（必需）"]
-        FILES["检查引用文件<br/>- components.tasks 存在？<br/>- components.agents 存在？"]
-    end
-
-    STRUCTURE --> TASKS_V["4. 任务验证"]
-
-    subgraph TASKS_V["任务格式检查"]
-        T_FIELDS["必需字段：<br/>- task<br/>- responsavel<br/>- responsavel_type<br/>- atomic_layer<br/>- Entrada<br/>- Saida<br/>- Checklist"]
-        T_NAMING["命名约定<br/>kebab-case"]
-    end
-
-    TASKS_V --> AGENTS_V["5. 代理验证"]
-
-    subgraph AGENTS_V["代理检查"]
-        A_FORMAT["代理格式<br/>- YAML frontmatter<br/>- Markdown 标题"]
-        A_NAMING["命名约定<br/>kebab-case"]
-    end
-
-    AGENTS_V --> RESULT{"结果？"}
-
-    RESULT -->|"错误 = 0"| VALID["有效"]
-    RESULT -->|"错误 > 0"| INVALID["无效"]
-    RESULT -->|"警告 > 0"| WARNINGS["有效（有警告）"]
-
-    style MANIFEST fill:#fff3e0
-    style STRUCTURE fill:#e1f5fe
-    style TASKS_V fill:#e8f5e9
-    style AGENTS_V fill:#fce4ec
-    style VALID fill:#c8e6c9
-    style INVALID fill:#ffcdd2
-    style WARNINGS fill:#fff9c4
-```
-
----
-
-## 命令到任务的映射
-
-### 小队管理命令
-
-| 命令 | 任务文件 | 操作 |
-|---------|-----------|----------|
-| `*create-squad` | `squad-creator-create.md` | 创建带完整结构的小队 |
-| `*create-squad --from-design` | `squad-creator-create.md` | 从蓝图创建小队 |
-| `*design-squad` | `squad-creator-design.md` | 通过文档分析设计小队 |
-| `*validate-squad` | `squad-creator-validate.md` | 验证小队针对 schema |
-| `*list-squads` | `squad-creator-list.md` | 列出本地小队 |
-| `*analyze-squad` | `squad-creator-analyze.md` | 分析结构并建议改进 |
-| `*extend-squad` | `squad-creator-extend.md` | 用新组件扩展小队 |
-
-### 编排和技能命令（v2）
-
-| 命令 | 任务文件 | 操作 |
-|---------|-----------|----------|
-| `*generate-skills` | `squad-generate-skills.md` | 生成小队知识技能 |
-| `*generate-workflow` | `squad-generate-workflow.md` | 生成 YAML 编排工作流 |
-| `*migrate-to-v2` | `squad-creator-migrate.md` | 迁移小队到 v2 格式 |
-
-### 分发命令（Sprint 8 - 占位符）
-
-| 命令 | 任务文件 | 操作 |
-|---------|-----------|----------|
-| `*download-squad` | `squad-creator-download.md` | 从 sinapse-squads 下载小队 |
-| `*publish-squad` | `squad-creator-publish.md` | 发布小队到 sinapse-squads |
-| `*sync-squad-sinapse` | `squad-creator-sync-sinapse.md` | 同步小队到 SINAPSE API |
-
-### 单个组件命令
-
-| 命令 | 任务文件 | 操作 |
-|---------|-----------|----------|
-| `*create-agent` | `create-agent.md` | 创建代理定义 |
-| `*create-task` | `create-task.md` | 创建任务文件 |
-| `*create-workflow` | `create-workflow.md` | 创建编排工作流 |
-
----
-
-## 生成的小队结构
-
-### v2（默认 - 带编排）
-
-```text
-./squads/{squad-name}/
-├── squad.yaml                    # v2 清单（编排 + 技能）
-├── README.md                     # 文档
-├── config/
-│   ├── coding-standards.md      # 代码标准
-│   ├── tech-stack.md            # 技术栈
-│   └── source-tree.md           # 文档化结构
-├── agents/
-│   └── example-agent.md         # 带 skill_dispatch 的代理
-├── tasks/
-│   └── example-task.md          # 遵循 TASK-FORMAT-V1 的任务
-├── workflows/
-│   └── main-workflow.yaml       # 带阶段的工作流（v2）
-├── checklists/
-│   └── .gitkeep
-├── templates/
-│   └── .gitkeep
-├── tools/
-│   └── .gitkeep
-├── scripts/
-│   └── .gitkeep
-└── data/
-    └── .gitkeep
-```
-
-### v1（遗留）
-
-```text
-./squads/{squad-name}/
-├── squad.yaml                    # v1 清单（基本）
-├── README.md
-├── config/
-│   ├── coding-standards.md
-│   ├── tech-stack.md
-│   └── source-tree.md
-├── agents/
-│   └── example-agent.md
-├── tasks/
-│   └── example-agent-task.md
-├── workflows/
-│   └── .gitkeep                 # 空（无编排）
-├── checklists/
-│   └── .gitkeep
-├── templates/
-│   └── .gitkeep
-├── tools/
-│   └── .gitkeep
-├── scripts/
-│   └── .gitkeep
-└── data/
-    └── .gitkeep
-```
-
----
-
-## 代理之间的协作图
-
-```mermaid
-flowchart LR
-    subgraph SQUAD_CREATOR["@squad-creator (Craft)"]
-        SC_CREATE["*create-squad"]
-        SC_VALIDATE["*validate-squad"]
-        SC_LIST["*list-squads"]
-        SC_DESIGN["*design-squad"]
-        SC_MIGRATE["*migrate-to-v2"]
-    end
-
-    subgraph DEV["@dev (Dex)"]
-        DEV_IMPL["实现功能"]
-        DEV_CODE["编写小队代码"]
-    end
-
-    subgraph QA["@qa (Quinn)"]
-        QA_REVIEW["代码审查"]
-        QA_TEST["测试小队"]
-    end
-
-    subgraph DEVOPS["@devops (Gage)"]
-        DEVOPS_PUB["发布"]
-        DEVOPS_DEPLOY["部署"]
-    end
-
-    SQUAD_CREATOR -->|"结构已创建"| DEV
-    DEV -->|"代码就绪"| QA
-    QA -->|"已批准"| DEVOPS
-    SQUAD_CREATOR -->|"发布前验证"| DEVOPS
-
-    SQUADS[("./squads/")]
-    SINAPSE_SQUADS[("sinapse-squads")]
-    SINAPSE_MKT[("SINAPSE API")]
-
-    SC_CREATE --> SQUADS
-    SC_VALIDATE --> SQUADS
-    SC_LIST --> SQUADS
-    DEVOPS_PUB --> SINAPSE_SQUADS
-    DEVOPS_PUB --> SINAPSE_MKT
-
-    style SQUAD_CREATOR fill:#e3f2fd
-    style DEV fill:#e8f5e9
-    style QA fill:#fce4ec
-    style DEVOPS fill:#fff3e0
-```
-
----
-
-## 可用模板
-
-| 模板 | 描述 | 组件 |
-|----------|-----------|-------------|
-| `basic` | 最小结构 | 1 个代理、1 个任务 |
-| `etl` | 数据处理 | 2 个代理（extractor、transformer）、3 个任务、scripts |
-| `agent-only` | 仅代理 | 2 个代理（primary、helper）、无任务 |
-| `custom` | 通过蓝图 | 由设计定义 |
-
-## 模板版本
-
-| 版本 | 描述 | 功能 |
-|--------|-----------|----------|
-| `v2` | **默认** - 完整编排 | squad.yaml v2、workflow.yaml、代理中的 skill_dispatch |
-| `v1` | 遗留结构 | 基本 squad.yaml、无编排/技能 |
-
----
-
-## squad.yaml 的 JSON Schema
-
-### 必需字段
-
-```yaml
-name: string          # kebab-case，2-50 字符
-version: string       # semver（1.0.0）
-```
-
-### 可选字段
-
-```yaml
-short-title: string   # 最多 100 字符
-description: string   # 最多 500 字符
-author: string
-license: MIT | Apache-2.0 | ISC | GPL-3.0 | UNLICENSED
-slashPrefix: string   # 命令前缀
-tags: string[]        # 发现关键词
-
-sinapse:
-  minVersion: string  # SINAPSE 最低版本
-  type: squad
-
-components:
-  tasks: string[]     # 任务文件
-  agents: string[]    # 代理文件
-  workflows: string[]
-  checklists: string[]
-  templates: string[]
-  tools: string[]
-  scripts: string[]
-
-config:
-  extends: extend | override | none
-  coding-standards: string
-  tech-stack: string
-  source-tree: string
-
-dependencies:
-  node: string[]
-  python: string[]
-  squads: string[]
-```
-
----
-
-## 验证错误代码
-
-| 代码 | 严重性 | 描述 |
-|--------|------------|-----------|
-| `MANIFEST_NOT_FOUND` | 错误 | squad.yaml 或 config.yaml 未找到 |
-| `YAML_PARSE_ERROR` | 错误 | YAML 语法无效 |
-| `SCHEMA_ERROR` | 错误 | 清单不符合 JSON Schema |
-| `FILE_NOT_FOUND` | 错误 | 引用的文件不存在 |
-| `DEPRECATED_MANIFEST` | 警告 | 使用 config.yaml 而非 squad.yaml |
-| `MISSING_DIRECTORY` | 警告 | 预期目录未找到 |
-| `NO_TASKS` | 警告 | tasks/ 中无任务文件 |
-| `TASK_MISSING_FIELD` | 警告 | 任务缺少推荐字段 |
-| `AGENT_INVALID_FORMAT` | 警告 | 代理文件可能不符合格式 |
-| `INVALID_NAMING` | 警告 | 文件名不是 kebab-case |
-
----
-
-## 分发级别
-
-```mermaid
-flowchart LR
-    subgraph LOCAL["级别 1：本地"]
-        L_PATH["./squads/"]
-        L_DESC["私有、项目特定"]
-        L_CMD["*create-squad"]
-    end
-
-    subgraph PUBLIC["级别 2：公共"]
-        P_REPO["github.com/SinapseAI/sinapse-squads"]
-        P_DESC["社区小队（免费）"]
-        P_CMD["*publish-squad"]
-    end
-
-    subgraph MARKET["级别 3：市场"]
-        M_API["api.sinapse.ai/squads"]
-        M_DESC["通过 SINAPSE API 的高级小队"]
-        M_CMD["*sync-squad-sinapse"]
-    end
-
-    LOCAL --> PUBLIC
-    PUBLIC --> MARKET
-
-    style LOCAL fill:#e8f5e9
-    style PUBLIC fill:#e3f2fd
-    style MARKET fill:#fff3e0
-```
-
----
-
-## 最佳实践
-
-### 小队创建
-
-1. **始终从设计开始** - 复杂项目使用 `*design-squad`
-2. **遵循任务优先** - 任务是主要入口点
-3. **默认使用 v2** - 支持编排和技能
-4. **分发前验证** - `*validate-squad` 必需
-5. **良好文档** - README.md 和 YAML 注释
-
-### 组件组织
-
-1. **命名**：始终使用 kebab-case
-2. **任务**：包含 TASK-FORMAT-V1 所有必需字段
-3. **代理**：使用带 `agent:` 块的 YAML frontmatter
-4. **配置**：指定继承模式（extend/override/none）
-
-### 验证
-
-1. **提交前**：提交前执行 `*validate-squad`
-2. **CI/CD**：在管道中集成验证
-3. **严格模式**：使用 `--strict` 将警告视为错误
-4. **修正**：处理警告以提高质量
-
-### 分发
-
-1. **本地测试** - 发布前验证和使用
-2. **文档** - 完整 README 和清晰描述
-3. **版本控制** - 正确使用 semver
-4. **许可证** - 指定适当的许可证
-
----
-
-## 故障排除
-
-### 小队未出现在 *list-squads
-
-- 验证目录在 `./squads/` 中存在
-- 检查 `squad.yaml` 或 `config.yaml` 存在
-- 验证清单的 YAML 语法
-
-### 验证失败 SCHEMA_ERROR
-
-- 检查 `name` 字段（必须是 kebab-case）
-- 检查 `version` 字段（必须是 semver：1.0.0）
-- 使用 YAML linter 验证语法
-
-### 验证失败 FILE_NOT_FOUND
-
-- 验证 `components` 中列出的文件
-- 检查相对路径（相对于小队目录）
-- 创建缺失文件或从列表中移除
-
-### 任务报告 TASK_MISSING_FIELD
-
-- 添加必需字段：
-  - `task:`、`responsavel:`、`responsavel_type:`
-  - `atomic_layer:`、`Entrada:`、`Saida:`、`Checklist:`
-- 遵循 TASK-FORMAT-SPECIFICATION-V1 格式
-
-### 蓝图生成失败
-
-- 提供更详细的文档
-- 使用 `--verbose` 查看分析
-- 使用 `--domain` 提供上下文
-
-### *create-squad --from-design 失败
-
-- 验证蓝图在指定路径存在
-- 验证蓝图的 YAML 语法
-- 检查所有必需字段是否存在
-
----
-
-## 参考
-
-- [任务：squad-creator-create.md](.sinapse-ai/development/tasks/squad-creator-create.md)
-- [任务：squad-creator-validate.md](.sinapse-ai/development/tasks/squad-creator-validate.md)
-- [任务：squad-creator-design.md](.sinapse-ai/development/tasks/squad-creator-design.md)
-- [脚本：squad-generator.js](.sinapse-ai/development/scripts/squad/squad-generator.js)
-- [脚本：squad-validator.js](.sinapse-ai/development/scripts/squad/squad-validator.js)
-- [Schema：squad-schema.json](.sinapse-ai/schemas/squad-schema.json)
-- [代理：squad-creator.md](.sinapse-ai/development/agents/squad-creator.md)
-- [命令：squad-creator.md](.claude/commands/SINAPSE/agents/squad-creator.md)
-
----
-
-## 摘要
-
-| 方面 | 详情 |
-|---------|----------|
-| **核心任务总数** | 12 个任务文件 |
-| **活跃任务** | 9 个（create、design、validate、list、analyze、extend、migrate、generate-skills、generate-workflow） |
-| **占位符任务** | 3 个（download、publish、sync-sinapse） |
-| **支持脚本** | 9 个脚本在 squad/ |
-| **Schemas** | 2 个（squad-schema、squad-design-schema） |
-| **模板** | 3 个（basic、etl、agent-only） |
-| **模板版本** | 2 个（v1 遗留、v2 编排） |
-| **分发级别** | 3 个（本地、sinapse-squads、SINAPSE API） |
-
----
-
-## 变更日志
-
-| 日期 | 作者 | 描述 |
-|------|-------|-----------|
-| 2026-02-04 | @squad-creator | 创建包含 7 个 Mermaid 图的初始文档 |
-
----
-
-*-- Craft，始终结构化*