sdd-full 1.0.0 → 1.1.0

package/README.md

@@ -1,49 +1,94 @@
 # sdd-full
 
-一键生成标准技能，自动适配 Trae-CN 和 Claude Code。
+完整的软件设计开发技能包
 
-## 安装使用
+## 概述
 
-在任意项目根目录执行：
+`sdd-full` 是一个全面的软件开发技能包，包含了从需求分析到发布上线的完整开发流程技能。
+
+## 安装
 
 ```bash
-npx sdd-full
+npm install sdd-full
+```
+
+## 使用
+
+### JavaScript API 使用
+
+```javascript
+const sdd = require('sdd-full');
+
+// 获取所有技能列表
+console.log(sdd.getSkills());
+
+// 获取特定技能的内容
+console.log(sdd.getSkill('sdd-full'));
+
+// 获取技能决策树文档
+console.log(sdd.getDecisionTree());
+
+// 获取完整开发流程手册
+console.log(sdd.getDevGuide());
 ```
 
-## 包含技能
-
-- brainstorming
-- claudeception
-- competitive-brief
-- finishing-a-development-branch
-- market-research
-- mempalace-auto-saver
-- prd-write
-- quality-gate
-- receiving-code-review
-- release-flow
-- requesting-code-review
-- requirement-completion-officer
-- sdd
-- sdd-add
-- sdd-code
-- sdd-deploy
-- sdd-full
-- sdd-ops
-- sdd-test
-- security-audit
-- systematic-debugging
-- test-driven-development
-- ui-sdd
-- using-superpowers
-- verification-before-completion
-- writing-plans
-
-## 生成目录
-
-- `.trae/skills` - 适配 Trae-CN
-- `.claude/skills` - 适配 Claude Code
-
-## License
+### 命令行使用
+
+```bash
+# 直接运行查看技能包
+node node_modules/sdd-full/index.js
+```
+
+## 包含的技能
+
+### 需求分析类
+- brainstorming - 创意头脑风暴
+- market-research - 市场调研
+- competitive-brief - 竞品简报
+- prd-write - PRD 文档编写
+- requirement-completion-officer - 需求补全
+- sdd - 基础 SDD 拆分
+- sdd-full - 完整 SDD 流程
+
+### 设计规划类
+- ui-sdd - UI 交互 SDD
+- sdd-code - 功能实现 SDD
+- sdd-test - 测试 SDD
+- sdd-deploy - 部署 SDD
+- sdd-ops - 运维 SDD
+- writing-plans - 编写计划
+
+### 开发执行类
+- sdd-add - 快速迭代
+- test-driven-development - TDD 开发
+- systematic-debugging - 系统化调试
+- verification-before-completion - 完成前验证
+
+### 质量保障类
+- quality-gate - 质量门禁
+- security-audit - 安全审计
+
+### 发布运维类
+- finishing-a-development-branch - 完成开发分支
+- release-flow - 发布流程管理
+
+### 知识沉淀类
+- claudeception - 持续学习
+- mempalace-auto-saver - 记忆宫殿自动保存
+
+### 专项工具类
+- using-superpowers - Superpowers 全流程
+- requesting-code-review - 请求代码审查
+- receiving-code-review - 接收代码审查
+
+## 版本历史
+
+### v1.0.0 (2026-05-04)
+- 初始版本发布
+- 包含完整的技能体系
+- 包含技能决策树
+- 包含完整开发流程手册
+
+## 许可证
 
 MIT

package/index.js

@@ -1,38 +1,90 @@
-#!/usr/bin/env node
+// sdd-full npm 包
+// 完整的软件设计开发技能包
+
 const fs = require('fs');
 const path = require('path');
-const skillsData = require('./skills-data.js');
-
-const cwd = process.cwd();
-
-const targets = [
-  { name: 'Trae-CN', base: '.trae/skills' },
-  { name: 'Claude-Code', base: '.claude/skills' }
-];
 
-console.log('📦 Generating skills...');
-
-targets.forEach(({ name, base }) => {
-  const root = path.join(cwd, base);
-  console.log(`\n📂 Generating ${name} skills: ${base}`);
-
-  if (!fs.existsSync(root)) {
-    fs.mkdirSync(root, { recursive: true });
+// 技能包的主入口
+const SDD = {
+  version: '1.0.0',
+  name: 'sdd-full',
+  description: '完整的软件设计开发技能包',
+  
+  // 获取所有技能列表
+  getSkills: function() {
+    const skillsDir = path.join(__dirname, 'skills');
+    const skills = [];
+    
+    // 检查目录是否存在
+    if (fs.existsSync(skillsDir)) {
+      const items = fs.readdirSync(skillsDir);
+      
+      items.forEach(item => {
+        const itemPath = path.join(skillsDir, item);
+        const stat = fs.statSync(itemPath);
+        
+        // 只处理目录（技能），排除 .md 文件
+        if (stat.isDirectory() && !item.endsWith('.md')) {
+          const skillPath = path.join(itemPath, 'SKILL.md');
+          if (fs.existsSync(skillPath)) {
+            skills.push(item);
+          }
+        }
+      });
+    }
+    
+    return skills;
+  },
+  
+  // 获取特定技能的内容
+  getSkill: function(skillName) {
+    const skillPath = path.join(__dirname, 'skills', skillName, 'SKILL.md');
+    
+    if (fs.existsSync(skillPath)) {
+      return fs.readFileSync(skillPath, 'utf-8');
+    }
+    
+    return null;
+  },
+  
+  // 获取技能决策树文档
+  getDecisionTree: function() {
+    const docPath = path.join(__dirname, 'skills', '技能决策树.md');
+    
+    if (fs.existsSync(docPath)) {
+      return fs.readFileSync(docPath, 'utf-8');
+    }
+    
+    return null;
+  },
+  
+  // 获取完整开发流程手册
+  getDevGuide: function() {
+    const docPath = path.join(__dirname, 'skills', '完整开发流程手册.md');
+    
+    if (fs.existsSync(docPath)) {
+      return fs.readFileSync(docPath, 'utf-8');
+    }
+    
+    return null;
   }
+};
 
-  skillsData.forEach(skill => {
-    const skillDir = path.join(root, skill.name);
-    const mdPath = path.join(skillDir, 'SKILL.md');
+// 导出模块
+module.exports = SDD;
 
-    if (!fs.existsSync(skillDir)) {
-      fs.mkdirSync(skillDir, { recursive: true });
-    }
-
-    fs.writeFileSync(mdPath, skill.content, 'utf8');
-    console.log(`✅ ${base}/${skill.name}/SKILL.md`);
+// 如果直接运行，显示版本和技能列表
+if (require.main === module) {
+  console.log('========================================');
+  console.log(`  ${SDD.name} - ${SDD.description}`);
+  console.log(`  版本: ${SDD.version}`);
+  console.log('========================================');
+  
+  const skills = SDD.getSkills();
+  console.log('\n可用技能:');
+  skills.forEach(skill => {
+    console.log(`  - ${skill}`);
   });
-});
-
-console.log(`\n🎉 Successfully generated ${skillsData.length} skills!`);
-console.log('👉 Generated in:');
-targets.forEach(t => console.log(`   - ${t.base}`));
+  
+  console.log(`\n总计 ${skills.length} 个技能\n`);
+}

package/package.json

@@ -1,20 +1,33 @@
 {
   "name": "sdd-full",
-  "version": "1.0.0",
-  "description": "一键生成标准技能，自动适配 Trae-CN 和 Claude Code",
+  "version": "1.1.0",
+  "description": "SDD Full - 完整的软件设计开发技能包",
   "main": "index.js",
-  "bin": {
-    "sdd-full": "./index.js"
+  "keywords": [
+    "sdd",
+    "software design",
+    "development",
+    "skills",
+    "ai"
+  ],
+  "author": "",
+  "license": "MIT",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "start": "node index.js"
   },
   "files": [
     "index.js",
-    "skills-data.js"
+    "package.json",
+    "README.md",
+    "skills/"
   ],
-  "author": "",
-  "license": "MIT",
-  "keywords": [
-    "skills",
-    "trae",
-    "claude-code"
-  ]
-}
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "bugs": {
+    "url": ""
+  },
+  "homepage": ""
+}

package/skills/README.md

@@ -0,0 +1,75 @@
+# 技能文档目录索引
+
+## 概述
+
+本目录包含所有技能体系相关的文档，帮助你快速了解和使用整个技能体系。
+
+## 文档列表
+
+### 核心文档
+
+| 文档名称 | 路径 | 说明 |
+|---------|------|------|
+| **技能使用指南.md** | `技能使用指南.md` | 所有技能的使用场景、功能特点、与其他技能的关系，快速选择和使用合适的技能 |
+| **完整开发流程手册.md** | `完整开发流程手册.md` | 从需求想法到上线发布的完整端到端开发流程，包含每个阶段的目标、使用技能、产出物、检查清单 |
+| **技能决策树.md** | `技能决策树.md` | 什么场景用什么技能，快速决策选择 |
+| **技能体系完善建议.md** | `技能体系完善建议.md` | 技能体系的现状分析、完整技能列表、最佳实践 |
+
+## 快速开始
+
+### 新手入门
+1. 先看 **技能决策树.md** - 了解什么场景用什么技能
+2. 再看 **技能使用指南.md** - 了解所有技能的功能
+3. 最后看 **完整开发流程手册.md** - 了解端到端流程
+
+### 新项目
+1. 查看 **完整开发流程手册.md** - 了解完整流程
+2. 根据场景使用 **技能决策树.md** - 选择合适的技能
+3. 需要时参考 **技能使用指南.md** - 了解技能详情
+
+## 现有技能列表
+
+### 需求分析类
+- brainstorming - 创意头脑风暴
+- market-research - 市场调研
+- competitive-brief - 竞品简报
+- prd-write - PRD文档编写
+- requirement-completion-officer - 需求补全
+- sdd - 基础SDD拆分
+- sdd-full - 完整SDD流程
+
+### 设计规划类
+- ui-sdd - UI交互SDD
+- sdd-code - 功能实现SDD
+- sdd-test - 测试SDD
+- sdd-deploy - 部署SDD
+- sdd-ops - 运维SDD
+- writing-plans - 编写计划
+
+### 开发执行类
+- sdd-add - 快速迭代
+- test-driven-development - TDD开发
+- systematic-debugging - 系统化调试
+- verification-before-completion - 完成前验证
+
+### 质量保障类
+- quality-gate - 质量门禁
+- security-audit - 安全审计
+
+### 发布运维类
+- finishing-a-development-branch - 完成开发分支
+- release-flow - 发布流程
+
+### 知识沉淀类
+- claudeception - 持续学习
+- mempalace-auto-saver - 自动保存记忆
+
+### 专项工具类
+- using-superpowers - Superpowers全流程
+- requesting-code-review - 请求代码审查
+- receiving-code-review - 接收代码审查
+
+## 更新日志
+
+- 2026-05-04: 更新技能列表，匹配当前实际存在的技能
+- 2024-05-04: 创建目录索引，整理技能文档

package/skills/brainstorming/SKILL.md

@@ -0,0 +1,164 @@
+---
+name: brainstorming
+description: "在任何创意工作之前必须使用此技能 - 创建功能、构建组件、添加功能或修改行为。在实现之前探索用户意图、需求和设计。"
+---
+
+# 头脑风暴：将想法转化为设计
+
+通过自然的协作对话，帮助将想法转化为完整的设计和规范。
+
+首先了解当前项目上下文，然后一次一个问题地完善想法。一旦理解了要构建的内容，就展示设计并获得用户批准。
+
+<HARD-GATE>
+在展示设计并获得用户批准之前，不要调用任何实现技能、编写任何代码、搭建任何项目或采取任何实现行动。这适用于所有项目，无论其看似多么简单。
+</HARD-GATE>
+
+## 反模式："这太简单了，不需要设计"
+
+每个项目都需要经过这个过程。待办事项列表、单个功能实用程序、配置更改 - 所有这些都需要。"简单"项目是未经检验的假设导致最多浪费工作的地方。设计可以很短（对于真正简单的项目，几句话就够了），但你必须展示它并获得批准。
+
+## 检查清单
+
+你必须为以下每个项目创建任务并按顺序完成：
+
+1. **探索项目上下文** - 检查文件、文档、最近的提交
+2. **提供视觉 companion**（如果主题涉及视觉问题）- 这是单独的消息，不与澄清问题结合。请参阅下面的视觉 companion 部分。
+3. **提出澄清问题** - 一次一个，了解目的/约束/成功标准
+4. **提出2-3种方法** - 带有权衡和你的建议
+5. **展示设计** - 按复杂度分部分展示，每部分后获得用户批准
+6. **编写设计文档** - 保存到 `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md` 并提交
+7. **规范审查循环** - 调度 spec-document-reviewer 子代理，使用精心设计的审查上下文（绝不是你的会话历史）；修复问题并重新调度，直到获得批准（最多3次迭代，然后提交给人类）
+8. **用户审查书面规范** - 请用户在继续之前审查规范文件
+9. **过渡到实现** - 调用 writing-plans 技能创建实现计划
+
+## 流程
+
+```dot
+digraph brainstorming {
+    "探索项目上下文" [shape=box];
+    "前方有视觉问题？" [shape=diamond];
+    "提供视觉 Companion\n(单独消息，无其他内容)" [shape=box];
+    "提出澄清问题" [shape=box];
+    "提出2-3种方法" [shape=box];
+    "展示设计部分" [shape=box];
+    "用户批准设计？" [shape=diamond];
+    "编写设计文档" [shape=box];
+    "规范审查循环" [shape=box];
+    "规范审查通过？" [shape=diamond];
+    "用户审查规范？" [shape=diamond];
+    "调用 writing-plans 技能" [shape=doublecircle];
+
+    "探索项目上下文" -> "前方有视觉问题？";
+    "前方有视觉问题？" -> "提供视觉 Companion\n(单独消息，无其他内容)" [label="是"];
+    "前方有视觉问题？" -> "提出澄清问题" [label="否"];
+    "提供视觉 Companion\n(单独消息，无其他内容)" -> "提出澄清问题";
+    "提出澄清问题" -> "提出2-3种方法";
+    "提出2-3种方法" -> "展示设计部分";
+    "展示设计部分" -> "用户批准设计？";
+    "用户批准设计？" -> "展示设计部分" [label="否，修改"];
+    "用户批准设计？" -> "编写设计文档" [label="是"];
+    "编写设计文档" -> "规范审查循环";
+    "规范审查循环" -> "规范审查通过？";
+    "规范审查通过？" -> "规范审查循环" [label="发现问题，\n修复并重新调度"];
+    "规范审查通过？" -> "用户审查规范？" [label="已批准"];
+    "用户审查规范？" -> "编写设计文档" [label="要求更改"];
+    "用户审查规范？" -> "调用 writing-plans 技能" [label="已批准"];
+}
+```
+
+**最终状态是调用 writing-plans。** 不要调用 frontend-design、mcp-builder 或任何其他实现技能。头脑风暴后你唯一应该调用的技能是 writing-plans。
+
+## 流程说明
+
+**理解想法：**
+
+- 首先检查当前项目状态（文件、文档、最近的提交）
+- 在提出详细问题之前，评估范围：如果请求描述了多个独立子系统（例如，"构建一个包含聊天、文件存储、计费和分析的平台"），立即标记这一点。不要在需要先分解的项目上花费时间完善细节。
+- 如果项目太大，无法用单个规范覆盖，帮助用户分解为子项目：独立部分是什么，它们如何关联，应该按什么顺序构建？然后通过正常的设计流程对第一个子项目进行头脑风暴。每个子项目都有自己的规范 → 计划 → 实现周期。
+- 对于范围适当的项目，一次一个问题地完善想法
+- 尽可能使用多项选择题，但开放式问题也可以
+- 每条消息只提一个问题 - 如果一个主题需要更多探索，将其分解为多个问题
+- 关注理解：目的、约束、成功标准
+
+**探索方法：**
+
+- 提出2-3种不同的方法，包括权衡
+- 以对话方式展示选项，包括你的建议和理由
+- 先提出你推荐的选项并解释原因
+
+**展示设计：**
+
+- 一旦你认为理解了要构建的内容，就展示设计
+- 根据复杂度调整每个部分：如果简单，几句话就够了；如果复杂，最多200-300字
+- 每部分后询问是否看起来正确
+- 涵盖：架构、组件、数据流、错误处理、测试
+- 准备在有不明白的地方回头澄清
+
+**设计隔离和清晰度：**
+
+- 将系统分解为更小的单元，每个单元有一个明确的目的，通过定义良好的接口进行通信，并且可以独立理解和测试
+- 对于每个单元，你应该能够回答：它做什么，如何使用它，它依赖什么？
+- 有人能在不阅读内部代码的情况下理解一个单元的作用吗？你能在不破坏消费者的情况下更改内部代码吗？如果不能，边界需要改进。
+- 更小、边界明确的单元也更容易使用 - 你对能一次保持在上下文中的代码推理得更好，当文件集中时，你的编辑更可靠。当文件变大时，这通常是它做得太多的信号。
+
+**在现有代码库中工作：**
+
+- 在提出更改之前探索当前结构。遵循现有模式。
+- 在现有代码存在影响工作的问题的地方（例如，文件变得太大、边界不明确、职责混乱），将有针对性的改进作为设计的一部分 - 就像优秀的开发人员改进他们正在工作的代码一样。
+- 不要提出无关的重构。保持专注于服务当前目标的内容。
+
+## 设计之后
+
+**文档：**
+
+- 将验证后的设计（规范）写入 `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md`
+  - （用户对规范位置的偏好覆盖此默认值）
+- 如果可用，使用 elements-of-style:writing-clearly-and-concisely 技能
+- 将设计文档提交到 git
+
+**规范审查循环：**
+编写规范文档后：
+
+1. 调度 spec-document-reviewer 子代理（参见 spec-document-reviewer-prompt.md）
+2. 如果发现问题：修复，重新调度，重复直到批准
+3. 如果循环超过3次迭代，提交给人类指导
+
+**用户审查关卡：**
+规范审查循环通过后，请用户在继续之前审查书面规范：
+
+> "规范已编写并提交到 `<path>`。请审查它，并让我知道在我们开始编写实现计划之前是否要进行任何更改。"
+
+等待用户的响应。如果他们要求更改，进行更改并重新运行规范审查循环。只有在用户批准后才能继续。
+
+**实现：**
+
+- 调用 writing-plans 技能创建详细的实现计划
+- 不要调用任何其他技能。writing-plans 是下一步。
+
+## 关键原则
+
+- **一次一个问题** - 不要用多个问题压倒用户
+- **首选多项选择题** - 在可能的情况下比开放式问题更容易回答
+- **严格遵循 YAGNI** - 从所有设计中删除不必要的功能
+- **探索替代方案** - 在确定之前始终提出2-3种方法
+- **增量验证** - 展示设计，在继续之前获得批准
+- **保持灵活** - 当有不明白的地方时回头澄清
+
+## 视觉 Companion
+
+一个基于浏览器的 companion，用于在头脑风暴期间显示模型、图表和视觉选项。作为工具提供 - 不是模式。接受 companion 意味着它可用于受益于视觉处理的问题；这并不意味着每个问题都通过浏览器进行。
+
+**提供 companion：** 当你预计即将提出的问题将涉及视觉内容（模型、布局、图表）时，一次提出请求获得同意：
+> "我们正在处理的一些内容可能更容易在网页浏览器中向您展示。我可以在我们进行过程中准备模型、图表、比较和其他视觉内容。此功能仍处于新状态，可能会消耗较多 tokens。想尝试一下吗？（需要打开本地 URL）"
+
+**此提议必须是单独的消息。** 不要将其与澄清问题、上下文摘要或任何其他内容结合。消息应只包含上述提议，别无其他。在继续之前等待用户的响应。如果他们拒绝，继续使用纯文本头脑风暴。
+
+**每个问题的决定：** 即使在用户接受后，也要为每个问题决定是使用浏览器还是终端。测试：**用户通过查看是否比阅读更能理解这一点？**
+
+- **使用浏览器** 处理视觉内容 - 模型、线框图、布局比较、架构图表、并排视觉设计
+- **使用终端** 处理文本内容 - 需求问题、概念选择、权衡列表、A/B/C/D 文本选项、范围决策
+
+关于 UI 主题的问题并不自动成为视觉问题。"在这种情况下，个性意味着什么？"是一个概念性问题 - 使用终端。"哪种向导布局更好？"是一个视觉问题 - 使用浏览器。
+
+如果他们同意使用 companion，请在继续之前阅读详细指南：
+`skills/brainstorming/visual-companion.md`

package/skills/claudeception/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: claudeception
+description: |
+  持续学习系统，从工作会话中提取可复用知识。
+  触发词：/claudeception、"把这个保存为技能"、"提取技能"、"我们学到了什么？"，
+  或在非显而易见的调试、变通方案、试错发现后。
+  自动创建标准化的 Trae 技能以便未来复用。
+tags:
+  - 学习
+  - 技能提取
+  - 自动化
+  - 调试
+  - 工作流
+version: 3.0.0
+author: Trae Code
+enabled: true
+run_on:
+  - manual
+  - after_task
+when:
+  any:
+    - command: /claudeception
+    - user_contains:
+        - save this as a skill
+        - extract a skill from this
+        - what did we learn
+        - 把这个保存为技能
+        - 提取技能
+        - 我们学到了什么
+    - task_has:
+        - debugging
+        - workaround
+        - trial_and_error
+        - non_obvious_solution
+tool_allowlist:
+  - read
+  - write
+  - edit
+  - grep
+  - glob
+  - web_search
+  - web_fetch
+  - skill
+  - ask_user
+  - todo
+---
+
+# Claudeception（Trae 版）
+
+持续学习系统，从工作会话中提取可复用知识，并将其编码为标准化的 Trae 技能，实现自主改进。
+
+## 何时提取技能
+
+遇到以下情况时提取：
+1. **非显而易见的解决方案** - 调试、变通方案、难以发现的修复
+2. **项目特定模式** - 未在其他地方记录的约定
+3. **工具集成知识** - 超出基本文档的实际使用
+4. **错误解决** - 带有实际根因的误导性错误
+5. **工作流优化** - 简化的多步骤流程
+
+## 技能质量标准
+
+- 可在未来任务中复用
+- 非琐碎（需要发现，而不只是文档）
+- 具体的触发条件和清晰的解决方案
+- 已在实践中验证可行
+
+## 提取流程
+
+### 1. 检查现有技能
+搜索现有技能以避免重复：
+```sh
+# 项目级
+.trae-cn/skills/**/*.md
+
+# 用户级
+~/.trae-cn/skills/**/*.md
+```
+
+---
+
+## 使用说明
+
+由于系统安全限制，请手动复制此文件到：
+
+**项目级技能：**
+```
+cp claudeception-skill-zh.md /Users/xutao/Documents/trae_projects/todo-all-code/.trae/skills/claudeception/SKILL.md
+```
+
+**用户级技能（所有项目通用）：**
+```
+cp claudeception-skill-zh.md /Users/xutao/.trae-cn/skills/claudeception/SKILL.md
+```