sdd-full 5.0.0 → 5.0.2

package/.claude/standards/security-standard.md

@@ -0,0 +1,105 @@
+# 安全规范模板
+
+## 1. 认证与授权
+
+### 1.1 密码安全
+- 密码长度至少 8 位
+- 包含大小写字母、数字、特殊字符
+- 使用 bcrypt/argon2 哈希存储
+- 定期更换密码
+
+### 1.2 会话管理
+- 使用安全的 Session ID
+- 设置合理的会话超时
+- 支持会话注销
+- 检测异常登录
+
+### 1.3 多因素认证
+- 敏感操作要求二次验证
+- 支持短信/邮箱/令牌验证
+
+## 2. 数据安全
+
+### 2.1 数据加密
+- 传输层使用 HTTPS/TLS 1.2+
+- 敏感数据加密存储
+- 密钥安全管理
+- 定期轮换密钥
+
+### 2.2 数据备份
+- 定期全量备份
+- 加密备份数据
+- 备份恢复测试
+- 异地存储
+
+## 3. 输入验证
+
+### 3.1 服务端验证
+- 所有输入必须验证
+- 类型检查
+- 长度限制
+- 格式验证
+- 范围检查
+
+### 3.2 常见攻击防护
+- SQL 注入：使用参数化查询/ORM
+- XSS：输出编码
+- CSRF：使用 Token
+- 文件上传：验证类型、大小、内容
+
+## 4. API 安全
+
+- 使用 HTTPS
+- 认证授权
+- 请求签名
+- 频率限制
+- 输入验证
+- 错误信息脱敏
+
+## 5. 代码安全
+
+### 5.1 依赖管理
+- 定期更新依赖
+- 检查漏洞
+- 使用官方源
+- 锁定版本
+
+### 5.2 敏感信息
+- 不硬编码密钥
+- 使用环境变量
+- 配置文件加密
+- 日志脱敏
+
+## 6. 日志与监控
+
+### 6.1 安全日志
+- 记录登录/登出
+- 记录敏感操作
+- 记录异常访问
+- 保留足够时间
+
+### 6.2 安全监控
+- 异常登录检测
+- 异常流量监控
+- 漏洞扫描
+- 定期安全审计
+
+## 7. 部署安全
+
+### 7.1 服务器安全
+- 最小化安装
+- 关闭不必要服务
+- 定期更新补丁
+- 防火墙配置
+
+### 7.2 容器安全
+- 使用官方基础镜像
+- 最小化镜像
+- 不使用 root 用户
+- 扫描镜像漏洞
+
+## 8. 安全培训
+
+- 定期安全培训
+- 安全意识教育
+- 应急演练

package/.claude/standards/ui-standard.md

@@ -0,0 +1,101 @@
+# UI 规范模板
+
+## 1. 设计原则
+
+### 1.1 一致性
+- 统一的视觉风格
+- 一致的交互模式
+- 统一的术语和文案
+
+### 1.2 可用性
+- 界面简洁清晰
+- 操作流程简单
+- 反馈及时明确
+
+### 1.3 可访问性
+- 支持键盘导航
+- 语义化 HTML
+- 适当的颜色对比度
+
+## 2. 颜色规范
+
+### 2.1 主色调
+- 主色：`#1890ff` (品牌色)
+- 成功：`#52c41a`
+- 警告：`#faad14`
+- 错误：`#ff4d4f`
+- 信息：`#1890ff`
+
+### 2.2 中性色
+- 标题：`#262626`
+- 正文：`#595959`
+- 辅助：`#8c8c8c`
+- 禁用：`#bfbfbf`
+- 边框：`#d9d9d9`
+- 背景：`#f5f5f5`
+
+## 3. 字体规范
+
+### 3.1 字体族
+- 中文：PingFang SC, Microsoft YaHei, sans-serif
+- 英文：Helvetica Neue, Arial, sans-serif
+- 代码：Monaco, Consolas, monospace
+
+### 3.2 字体大小
+- 超大标题：32px
+- 大标题：24px
+- 标题：20px
+- 副标题：18px
+- 正文：14px
+- 小字：12px
+
+## 4. 间距规范
+
+- 基础间距：8px
+- 小间距：4px
+- 标准间距：16px
+- 大间距：24px
+- 超大间距：32px
+
+## 5. 组件规范
+
+### 5.1 按钮
+- 主按钮：实心背景 + 白色文字
+- 次要按钮：边框 + 主色文字
+- 文字按钮：仅文字
+- 危险按钮：红色主题
+
+### 5.2 表单
+- 必填项标记：`*`
+- 错误提示：红色文字 + 图标
+- 输入框高度：32px / 40px
+
+### 5.3 卡片
+- 圆角：4px / 8px
+- 阴影：根据层级调整
+- 内边距：16px / 24px
+
+## 6. 响应式设计
+
+- 移动端：< 768px
+- 平板：768px - 1024px
+- 桌面：> 1024px
+
+## 7. 交互规范
+
+### 7.1 加载状态
+- 按钮加载时禁用并显示 loading 图标
+- 页面加载显示骨架屏或 spinner
+- 数据加载失败提供重试按钮
+
+### 7.2 反馈
+- 操作成功显示成功提示
+- 操作失败显示错误原因
+- 表单验证实时反馈
+
+## 8. 图标规范
+
+- 使用统一图标库
+- 图标风格一致
+- 尺寸统一
+- 语义准确

package/bin.js

@@ -6,7 +6,7 @@ const fs = require('fs');
 const path = require('path');
 
 const SDD = {
-  version: '5.0.0',
+  version: '5.0.2',
   name: 'sdd-full',
   description: '完整的软件设计开发技能包'
 };
@@ -107,10 +107,9 @@ function install(targetDir, environment) {
       { name: '通用 sdd-full', skillsPath: path.join(baseDir, '.sdd-full', 'skills'), rulesPath: path.join(baseDir, '.sdd-full', 'rules') }
     ];
   } else {
-    // 默认：Trae / Solo + Trae-cn
+    // 默认：Trae / Solo
     installConfig = [
-      { name: 'Trae / Solo', skillsPath: path.join(baseDir, '.trae', 'skills'), rulesPath: path.join(baseDir, '.trae', 'rules') },
-      { name: 'Trae-cn', skillsPath: path.join(baseDir, '.trae-cn', 'skills'), rulesPath: path.join(baseDir, '.trae-cn', 'rules') }
+      { name: 'Trae / Solo', skillsPath: path.join(baseDir, '.trae', 'skills'), rulesPath: path.join(baseDir, '.trae', 'rules') }
     ];
   }
   
@@ -240,7 +239,7 @@ function main() {
     console.log(`  版本: ${SDD.version}`);
     console.log('========================================');
     console.log('\n用法:');
-    console.log('  npx sdd-full              - 安装到 Trae / Solo + Trae-cn（默认）');
+    console.log('  npx sdd-full              - 安装到 Trae / Solo（默认）');
     console.log('  npx sdd-full cc           - 安装到 Claude Code');
     console.log('  npx sdd-full trae-cn      - 仅安装到 Trae-cn');
     console.log('  npx sdd-full all          - 安装到所有环境（Trae + Trae-cn + Claude Code）');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-full",
-  "version": "5.0.0",
+  "version": "5.0.2",
   "description": "SDD Full - 完整的软件设计开发技能包",
   "main": "index.js",
   "bin": "./bin.js",
@@ -22,7 +22,8 @@
     "index.js",
     "package.json",
     "README.md",
-    "skills/"
+    "skills/",
+    ".claude/"
   ],
   "repository": {
     "type": "git",

package/skills/enterprise-spec/SKILL.md

@@ -1,54 +0,0 @@
-name: 企业级全栈工程规范SDD
-description: 环境预检前置、项目目录、版本管理、交付物统一标准
-author: 
-version: 1.0.0
-trigger:
-  - 企业级工程规范
-  - 项目规范
-  - 工程标准
-tags:
-  - 工程规范
-  - 项目管理
-  - 交付标准
-
-【claude code调用标识：企业级全栈工程规范SDD】【trae调用标识：企业级全栈工程规范SDD+工程规范】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目】
-
-## 功能描述
-
-本技能提供企业级全栈工程规范SDD模板，包含环境预检前置、项目目录结构、版本管理和交付物统一标准。
-
-## 调用方式
-
-### Claude Code调用
-```
-调用 企业级全栈工程规范SDD 项目名称=电商平台
-```
-
-### Trae调用
-```
-trae调用 企业级全栈工程规范SDD 项目名称=电商平台 项目类型=企业级 流程场景=从零开始新项目
-```
-
-## 参数说明
-
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| 项目名称 | string | 是 | 项目名称 |
-| 项目类型 | string | 否 | 企业级/中小型/个人 |
-| 团队规模 | string | 否 | 团队人数 |
-
-## 输出内容
-
-1. 环境预检前置（本机配置、依赖工具、网络环境）
-2. 项目目录结构（标准结构、命名规范）
-3. 版本管理（分支策略、提交规范、版本命名）
-4. 交付物统一标准（代码交付、文档交付、部署交付）
-5. 质量保障（代码审查、安全审计）
-6. 验收标准（工程规范验证、交付物验证）
-
-## 适用场景
-
-- 新项目初始化
-- 团队规范制定
-- 项目重构
-- 质量保障

package/skills/flutter-av/SKILL.md

@@ -1,54 +0,0 @@
-name: Flutter音视频全栈SDD
-description: 离线ASR语音转写、TTS语音合成、OCR文字识别接入规范
-author: 
-version: 1.0.0
-trigger:
-  - Flutter音视频
-  - ASR语音转写
-  - TTS语音合成
-  - OCR识别
-tags:
-  - Flutter
-  - 音视频
-  - ASR
-  - TTS
-  - OCR
-
-【claude code调用标识：Flutter音视频全栈SDD】【trae调用标识：Flutter音视频全栈SDD+音视频集成】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
-
-## 功能描述
-
-本技能提供Flutter音视频全栈SDD模板，包含离线ASR语音转写、TTS语音合成、OCR文字识别的接入规范，帮助团队规范音视频功能开发。
-
-## 调用方式
-
-### Claude Code调用
-```
-调用 Flutter音视频全栈SDD 项目名称=语音助手APP
-```
-
-### Trae调用
-```
-trae调用 Flutter音视频全栈SDD 项目名称=语音助手APP 功能模块=ASR 流程场景=从零开始新项目
-```
-
-## 参数说明
-
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| 项目名称 | string | 是 | 项目名称 |
-| 功能模块 | string | 否 | ASR/TTS/OCR |
-
-## 输出内容
-
-1. 离线ASR（SDK集成、配置说明、核心功能、权限配置）
-2. TTS语音合成（SDK集成、配置说明、核心功能、平台差异）
-3. OCR文字识别（SDK集成、配置说明、核心功能、权限配置）
-4. 验收标准（ASR验收、TTS验收、OCR验收）
-
-## 适用场景
-
-- 语音助手开发
-- 文字识别应用
-- 音视频功能集成
-- 多媒体应用开发

package/skills/flutter-map/SKILL.md

@@ -1,54 +0,0 @@
-name: Flutter地图导航业务SDD
-description: 高德SDK集成、Marker警告处理、地图不显示问题落地规范
-author: 
-version: 1.0.0
-trigger:
-  - Flutter地图导航
-  - 高德地图集成
-  - 地图开发
-tags:
-  - Flutter
-  - 地图
-  - 高德SDK
-  - 导航
-
-【claude code调用标识：Flutter地图导航业务SDD】【trae调用标识：Flutter地图导航业务SDD+地图集成】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
-
-## 功能描述
-
-本技能提供Flutter地图导航业务SDD模板，包含高德SDK集成、Marker处理和常见问题解决方案，帮助团队规范地图功能开发。
-
-## 调用方式
-
-### Claude Code调用
-```
-调用 Flutter地图导航业务SDD 项目名称=骑手端APP
-```
-
-### Trae调用
-```
-trae调用 Flutter地图导航业务SDD 项目名称=骑手端APP SDK版本=10.0.0 流程场景=从零开始新项目
-```
-
-## 参数说明
-
-| 参数名 | 类型 | 必填 | 说明 |
-|--------|------|------|------|
-| 项目名称 | string | 是 | 项目名称 |
-| SDK版本 | string | 否 | 高德SDK版本号 |
-| 功能范围 | string | 否 | 功能模块范围 |
-
-## 输出内容
-
-1. SDK集成（版本锁定、依赖配置、初始化时机）
-2. 核心功能（地图显示、定位服务、导航功能）
-3. Marker处理（创建、警告处理、自定义样式）
-4. 常见问题（地图不显示、定位失败、导航异常）
-5. 验收标准（功能验证、性能指标、稳定性测试）
-
-## 适用场景
-
-- 地图功能开发
-- 骑手端导航
-- LBS应用开发
-- 地图SDK集成

package/skills/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修复分析

package/skills/global-overlay-stack-standard/SKILL.md

@@ -1,83 +0,0 @@
-name: global-overlay-stack-standard
-description: 全局浮层栈与层级规范 - 跨技术栈通用浮层管理规则
-author:
-version: 1.0.0
-trigger:
-  - 浮层栈
-  - 浮层规范
-  - 弹窗管理
-  - 层级管理
-tags:
-  - 浮层管理
-  - 工程规范
-  - UI规范
-  - 跨端通用
-
-【claude code调用标识：global-overlay-stack-standard】【trae调用标识：global-overlay-stack-standard+浮层管理】【流程场景：1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
-
-## 功能说明
-
-跨技术栈通用浮层栈与层级规范，不绑定 Flutter / iOS / Android / H5 / 小程序。只管控浮层栈、层级、弹出流程、防重叠、关闭逻辑、交互规则，不涉及UI动画、不限制具体实现语法。
-
-## 核心定位
-
-跨技术栈通用，不绑定任何平台/框架；只管控浮层栈、层级、弹出流程、防重叠、关闭逻辑、交互规则，不涉及UI动画、不限制具体实现语法。
-
-## 强制规范规则
-
-### 1. 浮层栈统一管理
-所有浮层类型：全局悬浮窗、强拦截弹窗、普通对话框、底部弹层、居中弹窗、Toast 弱提示，全部强制纳入全局统一栈管理，禁止业务私自独立创建、私自挂载根节点。
-
-### 2. 全局固定层级优先级
-全局固定层级优先级（永久不可随意篡改）：
-全局悬浮窗 ＞ 强拦截权限弹窗 ＞ 普通业务对话框 ＞ 底部弹层 ＞ Toast 轻量提示
-
-### 3. 栈机制严格遵循
-浮层严格遵循后进先出栈机制，任何操作只允许作用于当前栈顶浮层，禁止跨层操作、跨层关闭。
-
-### 4. 防重叠强制流程
-- 同优先级浮层禁止并行同时弹出，必须串行排队，上一个关闭后才允许弹出下一个；
-- 新浮层弹出前必须校验栈顶同等级浮层，存在则拦截重复弹出或进入等待队列；
-- 限制全局最大浮层嵌套层数，超出层数直接拦截创建，杜绝无限堆叠重叠；
-- 页面路由跳转、退出登录、流程终止时，自动清空当前页面附属所有浮层，避免残留遮挡。
-
-### 5. 遮罩行为统一规范
-- 全局默认固定遮罩可关闭/不可关闭基线规则；
-- 业务页面不准单独改写遮罩点击逻辑、不准私自穿透遮罩事件。
-
-### 6. 系统返回逻辑统一
-- 优先关闭栈顶浮层；
-- 无任何浮层时，才允许执行原生页面回退。
-
-### 7. 标准调用能力
-全局仅开放三个标准调用能力：展示浮层、关闭栈顶、关闭全部；
-业务禁止私自销毁浮层、私自移除遮罩、私自修改层级权重。
-
-### 8. 需求变更流程
-所有浮层相关需求变更、流程改动，必须先更新 SDD 对应规则，再进行开发；
-代码实现必须对齐本规范与 SDD 定义，不得私自偏离。
-
-## 使用指南
-
-### 调用方式
-- **Claude Code**: 调用 global-overlay-stack-standard
-- **Trae**: trae调用 global-overlay-stack-standard
-
-### 适用场景
-- 新项目浮层架构设计
-- 现有项目浮层问题治理
-- 跨端统一浮层规范制定
-- 浮层重叠、层级混乱问题修复
-
-## AI协作规范
-
-| 阶段 | AI职责 | 人工校验要求 |
-|------|--------|-------------|
-| 浮层需求分析 | 梳理浮层类型、优先级、交互规则 | 确认浮层分类合理性 |
-| 规范落地 | 协助生成浮层管理代码框架 | 必须人工二次确认层级优先级 |
-| Bug修复 | 分析浮层重叠、层级混乱原因 | 验证修复方案符合规范 |
-
----
-
-**规范版本**: v1.0.0  
-**适用场景**: 跨技术栈通用浮层管理