sdd-full 1.0.0 → 1.2.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,172 @@
 #!/usr/bin/env node
-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' }
-];
+// sdd-full npm 包
+// 完整的软件设计开发技能包
 
-console.log('📦 Generating skills...');
-
-targets.forEach(({ name, base }) => {
-  const root = path.join(cwd, base);
-  console.log(`\n📂 Generating ${name} skills: ${base}`);
+const fs = require('fs');
+const path = require('path');
 
-  if (!fs.existsSync(root)) {
-    fs.mkdirSync(root, { recursive: true });
+// 技能包的主入口
+const SDD = {
+  version: '1.2.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;
+  },
+  
+  // 安装技能到当前目录
+  install: function(targetDir) {
+    const destDir = path.join(targetDir || process.cwd(), '.sdd-full', 'skills');
+    const sourceDir = path.join(__dirname, 'skills');
+    
+    console.log('========================================');
+    console.log(`  ${SDD.name} - ${SDD.description}`);
+    console.log(`  版本: ${SDD.version}`);
+    console.log('========================================');
+    console.log(`\n正在安装技能到: ${destDir}`);
+    
+    // 确保目标目录存在
+    if (!fs.existsSync(destDir)) {
+      fs.mkdirSync(destDir, { recursive: true });
+    }
+    
+    // 复制所有技能文件
+    let count = 0;
+    if (fs.existsSync(sourceDir)) {
+      const items = fs.readdirSync(sourceDir);
+      
+      items.forEach(item => {
+        const srcItem = path.join(sourceDir, item);
+        const destItem = path.join(destDir, item);
+        const stat = fs.statSync(srcItem);
+        
+        if (stat.isDirectory()) {
+          // 复制目录（技能）
+          copyDirectory(srcItem, destItem);
+          count++;
+        } else if (stat.isFile() && item.endsWith('.md')) {
+          // 复制文档文件
+          fs.copyFileSync(srcItem, destItem);
+        }
+      });
+    }
+    
+    console.log(`\n✅ 成功安装 ${count} 个技能！`);
+    console.log(`\n技能目录: ${destDir}`);
+    console.log('\n您现在可以在支持技能的环境中使用这些技能了！\n');
   }
+};
 
-  skillsData.forEach(skill => {
-    const skillDir = path.join(root, skill.name);
-    const mdPath = path.join(skillDir, 'SKILL.md');
-
-    if (!fs.existsSync(skillDir)) {
-      fs.mkdirSync(skillDir, { recursive: true });
+// 复制目录的辅助函数
+function copyDirectory(src, dest) {
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+  
+  const items = fs.readdirSync(src);
+  items.forEach(item => {
+    const srcPath = path.join(src, item);
+    const destPath = path.join(dest, item);
+    const stat = fs.statSync(srcPath);
+    
+    if (stat.isDirectory()) {
+      copyDirectory(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
     }
-
-    fs.writeFileSync(mdPath, skill.content, 'utf8');
-    console.log(`✅ ${base}/${skill.name}/SKILL.md`);
   });
-});
+}
+
+// 导出模块
+module.exports = SDD;
 
-console.log(`\n🎉 Successfully generated ${skillsData.length} skills!`);
-console.log('👉 Generated in:');
-targets.forEach(t => console.log(`   - ${t.base}`));
+// 如果直接运行，显示版本和技能列表或安装
+if (require.main === module) {
+  const args = process.argv.slice(2);
+  
+  if (args.includes('install') || args.includes('i')) {
+    // 安装模式
+    const targetIndex = args.indexOf('--dir') || args.indexOf('-d');
+    let targetDir;
+    if (targetIndex !== -1 && args[targetIndex + 1]) {
+      targetDir = args[targetIndex + 1];
+    }
+    SDD.install(targetDir);
+  } else {
+    // 默认显示模式
+    console.log('========================================');
+    console.log(`  ${SDD.name} - ${SDD.description}`);
+    console.log(`  版本: ${SDD.version}`);
+    console.log('========================================');
+    console.log('\n用法:');
+    console.log('  npx sdd-full              - 显示帮助和技能列表');
+    console.log('  npx sdd-full install      - 安装技能到当前目录');
+    console.log('  npx sdd-full i            - 安装技能（简写）');
+    console.log('  npx sdd-full install --dir ./my-project  - 安装到指定目录');
+    
+    const skills = SDD.getSkills();
+    console.log('\n可用技能:');
+    skills.forEach(skill => {
+      console.log(`  - ${skill}`);
+    });
+    
+    console.log(`\n总计 ${skills.length} 个技能\n`);
+  }
+}

package/package.json

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