sdd-full 3.2.0 → 4.2.0

package/skills/call-adaptation/call-adaptation-guide.md

@@ -1,136 +0,0 @@
-# 两种调用机制切换指南及异常处理
-
-## 一、切换逻辑
-
-### 1.1 使用claude code调用
-- 直接通过关键词触发，无需额外操作
-- 示例："调用brainstorming技能，项目名称：XX"
-
-### 1.2 使用trae调用
-
-#### 方式1：完整路径调用（标准）
-- 需按固定格式输入调用指令，包含技能文档路径、必传参数、流程场景
-- 格式：trae调用 skills/对应分类目录/技能名称.md 参数1=值1 参数2=值2 流程场景=场景名称
-- 示例：trae调用 skills/requirement-analysis/brainstorming.md 项目名称=XX 触发场景=需求分析 流程场景=从零开始新项目
-
-#### 方式2：模板快捷调用（推荐）
-- 无需填写完整路径，系统自动匹配templates目录及流程适配逻辑
-- 格式：trae调用 模板名称 必传参数 流程场景=场景名称
-- 示例：trae调用 Brain-SDD 项目名称=个人备忘录APP 阶段=初期想法收集 流程场景=从零开始新项目
-
-#### 方式3：简称快捷调用（最快捷）
-- 使用预设的模板简称，输入更简洁
-- 格式：trae快捷 模板简称 必传参数 流程场景=场景名称
-- 示例：trae快捷 Brain 项目名称=个人备忘录APP 阶段=初期想法收集 流程场景=从零开始新项目
-
-### 1.3 快捷指令映射表
-
-| 模板简称 | 完整模板名称 | 对应目录 |
-|---------|------------|---------|
-| Base | Base-SDD.md | skills/templates/ |
-| Brain | Brain-SDD.md | skills/templates/ |
-| Competitor | Competitor-SDD.md | skills/templates/ |
-| PRD | PRD-SDD.md | skills/templates/ |
-| UI | UI-SDD.md | skills/templates/ |
-| Code | Code-SDD.md | skills/templates/ |
-| API | API-SDD.md | skills/templates/ |
-| Env | Env-SDD.md | skills/templates/ |
-| Test | Test-SDD.md | skills/templates/ |
-
-### 1.4 SDD全流程场景说明
-
-| 流程场景 | 场景编号 | 适用范围 | 核心技能 |
-|---------|---------|---------|---------|
-| 完整3阶段SDD流程 | 1 | 大型项目、完整迭代 | sdd, brainstorming, prd-write, ui-sdd, sdd-code, sdd-test |
-| 从零开始新项目 | 2 | 新项目启动 | brainstorming, market-research, competitive-brief, prd-write |
-| 小型功能迭代 | 3 | 功能新增/优化 | sdd-add, sdd-code, sdd-test |
-| Bug处理 | 4 | Bug修复 | systematic-debugging, sdd-add, sdd-test |
-| 代码发布 | 5 | 版本发布 | quality-gate, release-flow, finishing-a-development-branch |
-
-### 1.5 按需加载优化逻辑
-
-基于流程场景拆分技能/模板加载范围，确保加载体积≤30k：
-
-| 流程场景 | 加载范围 | 排除技能 |
-|---------|---------|---------|
-| Bug处理 | systematic-debugging, sdd-add, sdd-test | market-research, competitive-brief, ui-sdd |
-| 代码发布 | quality-gate, release-flow, security-audit | brainstorming, ui-sdd, market-research |
-| 小型功能迭代 | sdd-add, sdd-code, sdd-test | competitive-brief, market-research |
-| 从零开始新项目 | brainstorming, market-research, competitive-brief, prd-write | sdd-deploy, sdd-ops |
-| 完整3阶段SDD流程 | 全部技能 | 无 |
-
-### 1.6 流程场景缓存策略
-
-- 高频流程（如小型功能迭代、Bug处理）：首次加载后缓存，后续调用无需重复加载
-- 低频流程（如完整3阶段SDD流程）：不缓存，每次调用重新加载
-- 缓存清理：定期清理过期缓存（建议每周一次）
-
-## 二、异常处理方案
-
-### 2.1 trae调用失败
-优先核对以下4点：
-1. 技能文档路径是否正确
-2. 文档头部是否有trae调用标识
-3. 必传参数是否完整
-4. 流程场景参数是否正确
-
-核对后重新触发调用，仍失败则检查缓存和加载配置。
-
-### 2.2 claude code调用失败
-- 无需额外核对，直接重试或手动选择技能选项
-- 简单流程场景可使用原生触发（/命令）提升效率
-
-### 2.3 两种机制均调用失败
-- 查看本指南及相关适配文档
-- 检查技能文档是否符合统一规范
-- 清除trae本地缓存后重试
-
-### 2.4 流程场景适配失败
-- 检查流程场景参数是否在允许范围内（场景编号1-5）
-- 核对call-adaptation中的场景适配逻辑
-- 检查按需加载配置是否正确
-
-## 三、技能文档规范检查清单
-
-| 检查项 | 说明 |
-|--------|------|
-| 双调用标识 | 文档头部是否包含【claude code调用标识】和【trae调用标识】 |
-| 流程场景标识 | 文档头部是否包含【流程场景：对应全流程场景（1-5）】 |
-| 命名规范 | 文件名是否与原始技能列表一致，无特殊字符 |
-| 选项式设计 | 是否每个模块都有可选项和自定义补充入口 |
-| 参数说明 | 是否包含trae调用参数说明（调用路径、必传/可选参数、流程场景参数） |
-| 路径匹配 | 调用路径是否与实际目录结构一致 |
-| 流程衔接 | 是否包含流程衔接说明（前后步骤关联） |
-
-## 四、技能目录结构参考
-
-```
-skills/
-├─ requirement-analysis/     # 需求分析类（brainstorming, market-research, competitive-brief, prd-write, requirement-completion-officer, sdd, sdd-full, unified-flow）
-├─ design-planning/          # 设计规划类（ui-sdd, sdd-code, sdd-test, sdd-deploy, sdd-ops, writing-plans）
-├─ development-execution/    # 开发执行类（sdd-add, test-driven-development, systematic-debugging, verification-before-completion）
-├─ quality-assurance/        # 质量保障类（quality-gate, security-audit）
-├─ release-ops/              # 发布运维类（finishing-a-development-branch, release-flow）
-├─ knowledge-precipitation/  # 知识沉淀类（claudeception, mempalace-auto-saver）
-├─ special-tools/            # 专项工具类（using-superpowers, requesting-code-review, receiving-code-review）
-├─ call-adaptation/          # 调用机制适配
-├─ sdd-framework/            # SDD框架模板
-└─ templates/                # SDD模板
-```
-
-## 五、调用标识格式规范
-
-### 5.1 统一标识格式
-```
-【claude code调用标识：技能/模板名称】【trae调用标识：技能/模板名称+关联项】【流程场景：对应全流程场景（1-5）】
-```
-
-### 5.2 示例
-```
-【claude code调用标识：Brain-SDD】【trae调用标识：Brain-SDD+头脑风暴】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目】
-```
-
----
-
-**版本**: v2.0  
-**适用场景**: 两种调用机制切换与异常处理、SDD全流程适配

package/skills/call-adaptation/claude-code-call-spec.md

@@ -1,50 +0,0 @@
-# claude code调用机制说明及技能文档适配规范
-
-## 一、claude code调用机制核心特性
-
-### 1.1 调用触发方式
-- 支持关键词触发、主动调用两种方式
-- 可直接读取技能文档中的选项式内容，自动匹配调用逻辑
-
-### 1.2 文档解析逻辑
-- 可自动解析技能文档中的层级结构（标题、列表、选项）
-- 无需额外标注，直接提取核心调用信息
-
-### 1.3 异常处理
-- 调用失败时可自动重试，或提示手动选择技能选项
-
-## 二、技能文档适配规范
-
-### 2.1 调用标识要求
-所有技能文档头部添加claude code调用标识（可选但推荐）：
-```markdown
-【claude code调用标识：技能名称】
-```
-
-### 2.2 选项式设计要求
-技能文档采用选项式设计，便于AI调用：
-- 每个模块提供明确可选项
-- 保留自定义补充入口
-- 支持多选
-
-### 2.3 命名规范
-- 技能文档命名格式：技能名称.md（与原始技能列表一致）
-- 禁止使用特殊字符、空格
-
-## 三、调用示例
-
-```
-调用brainstorming技能，项目名称：个人备忘录APP
-```
-
-## 四、常见问题排查
-
-| 问题现象 | 可能原因 | 排查方法 |
-|---------|---------|---------|
-| 调用失败 | 技能名称不匹配 | 核对技能名称是否与原始列表一致 |
-| 选项缺失 | 选项式设计不完整 | 检查是否每个模块都有可选项 |
-
----
-
-**版本**: v1.0  
-**适用场景**: claude code平台技能调用

package/skills/call-adaptation/trae-call-spec.md

@@ -1,56 +0,0 @@
-# trae调用机制说明及技能文档适配规范
-
-## 一、trae调用机制核心特性
-
-### 1.1 调用触发方式
-- 仅支持指定格式触发，需明确技能文档路径、调用参数
-- 不支持关键词触发、不支持模糊匹配
-
-### 1.2 文档解析逻辑
-- 需在技能文档头部添加固定格式的调用标识
-- 调用标识格式：【trae调用标识：技能名称+关联SDD】
-- 示例：【trae调用标识：brainstorming+Brain-SDD】
-
-### 1.3 异常处理
-- 调用失败后直接返回错误提示
-- 需手动核对技能文档格式、调用路径后重新触发
-
-## 二、技能文档适配规范
-
-### 2.1 调用标识要求
-所有技能文档头部必须添加trae调用标识：
-```markdown
-【trae调用标识：技能名称+关联SDD模板名称】
-```
-
-### 2.2 参数说明要求
-在文档末尾补充trae调用参数说明：
-```markdown
-## trae调用参数说明（仅trae触发时使用）
-- 调用路径：skills/对应分类目录/技能名称.md
-- 必传参数：项目名称、技能触发场景
-- 可选参数：自定义选项补充内容
-```
-
-### 2.3 命名规范
-- 技能文档命名格式：技能名称.md（与原始技能列表一致）
-- 禁止使用特殊字符、空格
-
-## 三、调用示例
-
-```
-trae调用 skills/requirement-analysis/brainstorming.md 项目名称=个人备忘录APP 触发场景=需求分析阶段
-```
-
-## 四、常见问题排查
-
-| 问题现象 | 可能原因 | 排查方法 |
-|---------|---------|---------|
-| 调用失败 | 文档路径错误 | 核对skills目录结构 |
-| 解析失败 | 缺少调用标识 | 检查文档头部是否有trae调用标识 |
-| 参数错误 | 必传参数缺失 | 确认必传参数是否完整 |
-
----
-
-**版本**: v1.0  
-**适用场景**: trae平台技能调用

package/skills/checklist.md

@@ -1,154 +0,0 @@
-【claude code调用标识：SDD融合流程检查校验清单】【trae调用标识：SDD融合流程检查校验清单+文档校验】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
-
-# SDD融合流程检查校验清单
-
-## 一、技能文档规范检查
-
-### 1.1 双调用标识检查
-
-| 检查项 | 检查内容 | 状态 |
-|--------|---------|------|
-| [ ] | 文档头部包含【claude code调用标识】 | |
-| [ ] | 文档头部包含【trae调用标识】 | |
-| [ ] | 标识格式正确：【标识类型：技能/模板名称+关联项】 | |
-
-### 1.2 流程场景标识检查
-
-| 检查项 | 检查内容 | 状态 |
-|--------|---------|------|
-| [ ] | 文档头部包含【流程场景：对应全流程场景（1-5）】 | |
-| [ ] | 流程场景编号正确（1-5） | |
-| [ ] | 流程场景与技能类型匹配 | |
-
-### 1.3 参数说明检查
-
-| 检查项 | 检查内容 | 状态 |
-|--------|---------|------|
-| [ ] | 文档末尾包含trae调用参数说明 | |
-| [ ] | 包含调用路径 | |
-| [ ] | 包含必传参数 | |
-| [ ] | 包含可选参数 | |
-| [ ] | 包含流程场景参数 | |
-| [ ] | 包含流程衔接说明 | |
-
-### 1.4 命名规范检查
-
-| 检查项 | 检查内容 | 状态 |
-|--------|---------|------|
-| [ ] | 文件名与原始技能列表一致 | |
-| [ ] | 无特殊字符、空格 | |
-| [ ] | 使用.md格式 | |
-
-## 二、SDD模板规范检查
-
-### 2.1 选项式设计检查
-
-| 检查项 | 检查内容 | 状态 |
-|--------|---------|------|
-| [ ] | 每个模块有明确可选项 | |
-| [ ] | 保留自定义补充入口 | |
-| [ ] | 选项贴合AI调用需求 | |
-| [ ] | 选项与流程步骤对应 | |
-
-### 2.2 模板完整性检查
-
-| 模板名称 | 双标识 | 流程场景标识 | 参数说明 | 选项设计 | 状态 |
-|---------|--------|------------|---------|---------|------|
-| Base-SDD | [ ] | [ ] | [ ] | [ ] | |
-| Brain-SDD | [ ] | [ ] | [ ] | [ ] | |
-| Competitor-SDD | [ ] | [ ] | [ ] | [ ] | |
-| PRD-SDD | [ ] | [ ] | [ ] | [ ] | |
-| UI-SDD | [ ] | [ ] | [ ] | [ ] | |
-| Code-SDD | [ ] | [ ] | [ ] | [ ] | |
-| API-SDD | [ ] | [ ] | [ ] | [ ] | |
-| Env-SDD | [ ] | [ ] | [ ] | [ ] | |
-| Test-SDD | [ ] | [ ] | [ ] | [ ] | |
-| UI资源提示词生成SDD | [ ] | [ ] | [ ] | [ ] | |
-
-## 三、trae调用路径检查
-
-### 3.1 快捷调用映射检查
-
-| 简称 | 模板名称 | 路径 | 正确性 |
-|------|---------|------|--------|
-| Base | Base-SDD.md | skills/templates/ | [ ] |
-| Brain | Brain-SDD.md | skills/templates/ | [ ] |
-| Competitor | Competitor-SDD.md | skills/templates/ | [ ] |
-| PRD | PRD-SDD.md | skills/templates/ | [ ] |
-| UI | UI-SDD.md | skills/templates/ | [ ] |
-| Code | Code-SDD.md | skills/templates/ | [ ] |
-| API | API-SDD.md | skills/templates/ | [ ] |
-| Env | Env-SDD.md | skills/templates/ | [ ] |
-| Test | Test-SDD.md | skills/templates/ | [ ] |
-| UI提示词 | UI资源提示词生成SDD.md | skills/templates/ | [ ] |
-
-### 3.2 技能分类目录检查
-
-| 分类目录 | 包含技能 | 状态 |
-|---------|---------|------|
-| requirement-analysis/ | brainstorming, market-research, competitive-brief, prd-write, requirement-completion-officer, sdd, sdd-full, unified-flow | [ ] |
-| design-planning/ | ui-sdd, sdd-code, sdd-test, sdd-deploy, sdd-ops, writing-plans | [ ] |
-| development-execution/ | sdd-add, test-driven-development, systematic-debugging, verification-before-completion | [ ] |
-| quality-assurance/ | quality-gate, security-audit | [ ] |
-| release-ops/ | finishing-a-development-branch, release-flow | [ ] |
-| knowledge-precipitation/ | claudeception, mempalace-auto-saver | [ ] |
-| special-tools/ | using-superpowers, requesting-code-review, receiving-code-review | [ ] |
-
-### 3.3 按需加载配置检查
-
-| 流程场景 | 加载范围正确 | 排除技能正确 | 加载体积≤30k | 状态 |
-|---------|------------|-------------|-------------|------|
-| 完整3阶段SDD流程 | [ ] | [ ] | [ ] | |
-| 从零开始新项目 | [ ] | [ ] | [ ] | |
-| 小型功能迭代 | [ ] | [ ] | [ ] | |
-| Bug处理 | [ ] | [ ] | [ ] | |
-| 代码发布 | [ ] | [ ] | [ ] | |
-
-## 四、两种调用机制兼容性检查
-
-### 4.1 触发方式检查
-
-| 机制 | 关键词触发 | 路径触发 | 快捷触发 | 流程场景参数支持 |
-|------|-----------|---------|---------|----------------|
-| claude code | [ ] 支持 | [ ] 支持 | [ ] 支持 | [ ] 支持 |
-| trae | [ ] 支持 | [ ] 支持 | [ ] 支持 | [ ] 支持 |
-
-### 4.2 异常处理检查
-
-| 机制 | 自动重试 | 错误提示 | 手动核对 | 流程场景适配失败处理 |
-|------|---------|---------|---------|-------------------|
-| claude code | [ ] | [ ] | [ ] | [ ] |
-| trae | [ ] | [ ] | [ ] | [ ] |
-
-## 五、SDD全流程场景校验
-
-### 5.1 流程衔接检查
-
-| 阶段 | 对应技能 | 流程衔接说明 | 状态 |
-|------|---------|------------|------|
-| 阶段1（产品经理阶段） | brainstorming, market-research, competitive-brief, prd-write | [ ] | |
-| 阶段2（SDD拆分阶段） | sdd, ui-sdd, sdd-code, sdd-test, sdd-deploy, sdd-ops | [ ] | |
-| 阶段2.5（MVP验证阶段） | sdd-test（精简版） | [ ] | |
-| 阶段3（开发流程阶段） | sdd-add, test-driven-development, systematic-debugging, quality-gate, security-audit | [ ] | |
-
-### 5.2 各场景必调用技能检查
-
-| 流程场景 | 必调用技能 | 可选调用技能 | 状态 |
-|---------|-----------|------------|------|
-| 完整3阶段SDD流程 | sdd, brainstorming, prd-write, ui-sdd, sdd-code, sdd-test | market-research, competitive-brief, sdd-deploy | [ ] |
-| 从零开始新项目 | brainstorming, market-research, competitive-brief, prd-write | sdd | [ ] |
-| 小型功能迭代 | sdd-add, sdd-code, sdd-test | ui-sdd | [ ] |
-| Bug处理 | systematic-debugging, sdd-add, sdd-test | - | [ ] |
-| 代码发布 | quality-gate, release-flow, finishing-a-development-branch | security-audit | [ ] |
-
-## 六、定期检查频率
-
-- [ ] 每周：检查新增/修改的文档
-- [ ] 每月：全量检查所有文档
-- [ ] 版本发布前：完整检查
-- [ ] 流程场景变更后：检查适配逻辑
-
----
-
-**版本**: v2.0  
-**适用场景**: SDD融合流程文档规范检查、全流程适配校验

package/skills/design-planning/ai-coding-rules/SKILL.md

@@ -1,52 +0,0 @@
-name: Andrej Karpathy AI编码规则落地SDD
-description: 编码约束、开源/商用方案对比范式、禁止自由发挥落地细则
-author: 
-version: 1.0.0
-trigger:
-  - AI编码规则
-  - Karpathy规则
-  - 编码规范
-tags:
-  - 编码规范
-  - AI编码
-  - 开发规范
-
-【claude code调用标识：Andrej Karpathy AI编码规则落地SDD】【trae调用标识：Andrej Karpathy AI编码规则落地SDD+编码规范】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代】
-
-## 功能描述
-
-本技能提供Andrej Karpathy AI编码规则落地SDD模板，包含编码约束、开源/商用方案对比范式和禁止自由发挥落地细则。
-
-## 调用方式
-
-### Claude Code调用
-```
-调用 Andrej Karpathy AI编码规则落地SDD 项目名称=AI助手APP
-```
-
-### Trae调用
-```
-trae调用 Andrej Karpathy AI编码规则落地SDD 项目名称=AI助手APP 团队规模=10人 流程场景=完整3阶段SDD流程
-```
-
-## 参数说明
-
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| 项目名称 | string | 是 | 项目名称 |
-| 团队规模 | string | 否 | 团队人数 |
-| 项目类型 | string | 否 | 企业级/开源/个人 |
-
-## 输出内容
-
-1. 编码约束（THINK BEFORE YOU CODE、MAKE SURGICAL CHANGES、KEEP IT SIMPLE等）
-2. 开源/商用方案对比范式（对比维度、选择原则、决策流程）
-3. 禁止自由发挥落地细则（禁止项清单、审批流程、变更控制）
-4. 验收标准（编码规范验证、代码质量验证）
-
-## 适用场景
-
-- 编码规范制定
-- 团队开发规范
-- AI辅助开发
-- 代码质量保障

package/skills/design-planning/design-to-code/SKILL.md

@@ -1,53 +0,0 @@
-name: 高保真设计转代码SDD
-description: Rive动画、Figma设计稿转Flutter 1:1还原交付规范
-author: 
-version: 1.0.0
-trigger:
-  - 设计转代码
-  - Rive动画
-  - Figma转Flutter
-tags:
-  - 设计转代码
-  - Rive动画
-  - Figma
-  - Flutter
-
-【claude code调用标识：高保真设计转代码SDD】【trae调用标识：高保真设计转代码SDD+设计转代码】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代】
-
-## 功能描述
-
-本技能提供高保真设计转代码SDD模板，包含Rive动画集成和Figma设计稿转Flutter的1:1还原交付规范。
-
-## 调用方式
-
-### Claude Code调用
-```
-调用 高保真设计转代码SDD 项目名称=UI组件库
-```
-
-### Trae调用
-```
-trae调用 高保真设计转代码SDD 项目名称=UI组件库 设计稿链接=https://figma.com/xxx 流程场景=完整3阶段SDD流程
-```
-
-## 参数说明
-
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| 项目名称 | string | 是 | 项目名称 |
-| 设计稿链接 | string | 否 | Figma设计稿链接 |
-| 目标平台 | string | 否 | iOS/Android/Web |
-
-## 输出内容
-
-1. Rive动画集成（配置说明、依赖配置、集成流程、注意事项）
-2. Figma设计稿转Flutter（工具配置、1:1还原规范、转换流程、组件拆分原则）
-3. 交付标准（视觉还原度、交互还原度、代码质量）
-4. 验收标准（视觉验证、交互验证、代码验证）
-
-## 适用场景
-
-- UI组件开发
-- 动画效果实现
-- 设计稿还原
-- 视觉开发

package/skills/design-planning/function-sdd/SKILL.md

@@ -1,54 +0,0 @@
-name: 功能SDD专用模板
-description: 业务功能专属SDD模板、章节结构、必填项规范
-author: 
-version: 1.0.0
-trigger:
-  - 功能SDD专用模板
-  - 业务功能模板
-  - 功能设计规范
-tags:
-  - 功能设计
-  - SDD模板
-  - 业务规范
-
-【claude code调用标识：功能SDD专用模板】【trae调用标识：功能SDD专用模板+功能设计规范】【流程场景：1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
-
-## 功能描述
-
-本技能提供业务功能专属SDD模板，包含完整的章节结构和必填项规范，帮助团队规范功能设计流程。
-
-## 调用方式
-
-### Claude Code调用
-```
-调用 功能SDD专用模板 功能模块名称=用户登录
-```
-
-### Trae调用
-```
-trae调用 功能SDD专用模板 功能模块名称=用户登录 流程场景=小型功能迭代
-```
-
-## 参数说明
-
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| 功能模块名称 | string | 是 | 功能模块名称 |
-| 用户角色 | string | 否 | 目标用户角色 |
-| 功能范围 | string | 否 | 功能包含/不包含内容 |
-
-## 输出内容
-
-1. 需求描述（功能概述、用户故事、验收标准）
-2. 业务流程（流程图、状态转换、异常分支）
-3. 数据结构（实体定义、API接口、数据库设计）
-4. 界面设计（页面原型、交互逻辑、权限控制）
-5. 非功能需求（性能、安全、兼容性）
-6. 交付物清单（文档、代码、测试）
-
-## 适用场景
-
-- 功能开发设计
-- 需求评审
-- 技术方案设计
-- Bug修复分析