sdd-full 5.0.3 → 5.0.5

package/.claude/skills/sdd-code/SKILL.md

@@ -341,7 +341,16 @@ description: "功能实现逻辑SDD拆分，将用户故事拆分为独立可交
 - **sdd-add**：快速迭代补充（如需要）
 - **子代理开发**：执行SDD开发
 
-## 7.3 流程关系
+## 7.3 配套技能
+- **code-split-spec**：代码拆分规范，指导实际代码文件/模块/组件拆分
+- **state-management**：状态管理，处理应用状态管理
+- **data-fetching**：数据获取处理，统一API请求和缓存
+- **component-split**：组件拆分，前端组件化设计
+- **architecture-refactor**：架构重构，如需架构调整时使用
+- **code-review-standard**：代码审查标准，确保代码质量
+- **test-driven-development**：TDD开发，测试驱动开发
+
+## 7.4 流程关系
 ```
-sdd → ui-sdd → sdd-code → sdd-test → 开发
+sdd → ui-sdd → sdd-code → [code-split-spec/component-split/state-management/data-fetching → sdd-test → 开发 → code-review-standard
 ```

package/.claude/skills/sdd-common/SKILL.md

@@ -22,6 +22,9 @@ description: "SDD全流程通用可复用技能集合"
 - [sdd-deploy](#sdd-deploy) - 部署SDD
 - [writing-plans](#writing-plans) - 制定计划
 - [ui-motion-interaction-standard](#ui-motion-interaction-standard) - UI动效交互标准
+- [code-split-spec](#code-split-spec) - 代码拆分规范
+- [component-split](#component-split) - 组件拆分
+- [architecture-refactor](#architecture-refactor) - 架构重构执行
 
 ### 开发执行类
 - [sdd-add](#sdd-add) - 快速迭代
@@ -30,6 +33,8 @@ description: "SDD全流程通用可复用技能集合"
 - [verification-before-completion](#verification-before-completion) - 完成前验证
 - [design-to-code](#design-to-code) - 设计转代码
 - [performance-optimize](#performance-optimize) - 性能优化
+- [state-management](#state-management) - 状态管理
+- [data-fetching](#data-fetching) - 数据获取处理
 
 ### Flutter专项类
 - [flutter-apply-architecture-best-practices](#flutter-apply-architecture-best-practices) - Flutter架构适配
@@ -53,6 +58,7 @@ description: "SDD全流程通用可复用技能集合"
 - [bug-reproduction-confirm](#bug-reproduction-confirm) - Bug复现确认
 - [requesting-code-review](#requesting-code-review) - 请求代码审查
 - [receiving-code-review](#receiving-code-review) - 接收代码审查
+- [code-review-standard](#code-review-standard) - 代码审查标准
 
 ### 发布运维类
 - [finishing-a-development-branch](#finishing-a-development-branch) - 完成开发分支
@@ -376,3 +382,45 @@ description: "SDD全流程通用可复用技能集合"
 **描述**: 设计契约专家
 **适用场景**: API设计、接口契约
 **关键输出**: 契约文档
+
+---
+
+### code-split-spec
+**描述**: 代码拆分规范
+**适用场景**: 代码文件/模块/组件拆分、架构设计
+**关键输出**: 拆分后的代码结构、规范文档
+
+---
+
+### state-management
+**描述**: 状态管理
+**适用场景**: React/Vue/Flutter状态管理方案选择与实现
+**关键输出**: 状态管理代码、状态结构设计
+
+---
+
+### data-fetching
+**描述**: 数据获取处理
+**适用场景**: API请求、缓存策略、错误处理
+**关键输出**: 数据请求封装、缓存实现
+
+---
+
+### component-split
+**描述**: 组件拆分
+**适用场景**: 前端组件化拆分、可复用组件设计
+**关键输出**: 拆分后的组件、组件库
+
+---
+
+### architecture-refactor
+**描述**: 架构重构执行
+**适用场景**: 架构演进、代码重构、遗留系统改造
+**关键输出**: 重构计划、重构后的代码
+
+---
+
+### code-review-standard
+**描述**: 代码审查标准
+**适用场景**: 代码审查、质量把控
+**关键输出**: 审查报告、改进建议

package/.claude/skills/state-management/SKILL.md

@@ -0,0 +1,260 @@
+---
+name: state-management
+description: 状态管理技能 - 提供 React/Vue/Flutter 状态管理最佳实践和方案选择指导
+---
+
+# state-management - 状态管理技能
+
+## 概述
+
+提供状态管理的统一规范和最佳实践，帮助选择合适的状态管理方案，指导状态拆分、存储和更新。
+
+**核心原则：最小化状态、单一数据源、单向数据流**
+
+---
+
+## 1. 状态管理方案选择
+
+### 1.1 方案选型决策树
+
+```
+项目规模小/状态简单？
+├─ 是 → 使用框架原生状态（React useState/Vue data/Flutter State）
+└─ 否 → 需要共享状态？
+       ├─ 否 → 组件内状态
+       └─ 是 → 共享范围？
+              ├─ 局部（几个组件）→ Context/Provider/InheritedWidget
+              └─ 全局/复杂 → Redux/Zustand/Pinia/MobX/Bloc/Riverpod
+```
+
+### 1.2 各场景推荐方案
+
+| 场景 | React | Vue | Flutter |
+|-----|-------|-----|---------|
+| 小项目/简单状态 | useState | data/setup | State |
+| 父子组件共享 | Context + useReducer | Provide/Inject | InheritedWidget |
+| 中等项目 | Zustand/Jotai | Pinia | Provider |
+| 大项目/复杂流 | Redux Toolkit | Pinia + Vuex(legacy) | Bloc/Riverpod |
+
+---
+
+## 2. 状态拆分原则
+
+### 2.1 按生命周期拆分
+
+```
+1. 临时状态（UI状态）：表单输入、弹窗开关、加载状态 → 组件内
+2. 持久状态：用户偏好、主题设置 → LocalStorage/SharedPreferences
+3. 服务端状态：API数据 → 缓存层（React Query/SWR）
+4. URL状态：路由参数、查询字符串 → URL
+```
+
+### 2.2 按作用域拆分
+
+```
+全局状态：App主题、用户登录状态、权限
+  ↓
+模块状态：购物车、当前订单
+  ↓
+页面状态：列表筛选、分页
+  ↓
+组件状态：表单输入、动画进度
+```
+
+### 2.3 状态最小化原则
+
+- **不要存储可计算的数据**：从其他状态派生
+- **不要存储UI组件引用**：使用回调/事件
+- **保持状态扁平化**：避免深层嵌套
+
+```typescript
+// Bad: 存储派生数据
+const state = {
+  items: [...],
+  itemCount: 5, // 可从 items.length 计算
+  filteredItems: [...] // 可从 items 过滤
+};
+
+// Good: 只存储源数据
+const state = {
+  items: [...]
+};
+// 使用选择器获取派生数据
+const getItemCount = (state) => state.items.length;
+```
+
+---
+
+## 3. React 状态管理
+
+### 3.1 Zustand 实践（推荐）
+
+```typescript
+// store/useUserStore.ts
+import { create } from 'zustand';
+
+interface UserState {
+  user: User | null;
+  isLoading: boolean;
+  error: string | null;
+  setUser: (user: User) => void;
+  logout: () => void;
+  fetchUser: (id: string) => Promise<void>;
+}
+
+export const useUserStore = create<UserState>((set, get) => ({
+  user: null,
+  isLoading: false,
+  error: null,
+  
+  setUser: (user) => set({ user }),
+  
+  logout: () => set({ user: null }),
+  
+  fetchUser: async (id) => {
+    set({ isLoading: true, error: null });
+    try {
+      const user = await api.getUser(id);
+      set({ user, isLoading: false });
+    } catch (error) {
+      set({ error: error.message, isLoading: false });
+    }
+  }
+}));
+```
+
+### 3.2 状态拆分示例
+
+```
+src/stores/
+├── useUserStore.ts      # 用户相关
+├── useCartStore.ts      # 购物车
+├── useThemeStore.ts     # 主题
+└── useNotificationStore.ts # 通知
+```
+
+---
+
+## 4. Vue 状态管理
+
+### 4.1 Pinia 实践（推荐）
+
+```typescript
+// stores/user.ts
+import { defineStore } from 'pinia';
+import { ref, computed } from 'vue';
+
+export const useUserStore = defineStore('user', () => {
+  // State
+  const user = ref<User | null>(null);
+  const isLoading = ref(false);
+  const error = ref<string | null>(null);
+  
+  // Getters
+  const isLoggedIn = computed(() => !!user.value);
+  const userName = computed(() => user.value?.name || '');
+  
+  // Actions
+  async function fetchUser(id: string) {
+    isLoading.value = true;
+    error.value = null;
+    try {
+      user.value = await api.getUser(id);
+    } catch (err) {
+      error.value = err.message;
+    } finally {
+      isLoading.value = false;
+    }
+  }
+  
+  function logout() {
+    user.value = null;
+  }
+  
+  return { user, isLoading, error, isLoggedIn, userName, fetchUser, logout };
+});
+```
+
+---
+
+## 5. Flutter 状态管理
+
+### 5.1 Provider 实践（推荐入门）
+
+```dart
+// providers/user_provider.dart
+class UserProvider with ChangeNotifier {
+  User? _user;
+  bool _isLoading = false;
+  String? _error;
+  
+  User? get user => _user;
+  bool get isLoading => _isLoading;
+  String? get error => _error;
+  bool get isLoggedIn => _user != null;
+  
+  Future<void> fetchUser(String id) async {
+    _isLoading = true;
+    _error = null;
+    notifyListeners();
+    
+    try {
+      _user = await api.getUser(id);
+    } catch (e) {
+      _error = e.toString();
+    } finally {
+      _isLoading = false;
+      notifyListeners();
+    }
+  }
+  
+  void logout() {
+    _user = null;
+    notifyListeners();
+  }
+}
+```
+
+### 5.2 Riverpod 实践（推荐进阶）
+
+```dart
+// providers/user_provider.dart
+@riverpod
+class UserNotifier extends _$UserNotifier {
+  @override
+  FutureOr<User?> build() {
+    return null; // 初始状态
+  }
+  
+  Future<void> fetchUser(String id) async {
+    state = const AsyncLoading();
+    try {
+      final user = await api.getUser(id);
+      state = AsyncData(user);
+    } catch (e, stackTrace) {
+      state = AsyncError(e, stackTrace);
+    }
+  }
+  
+  void logout() {
+    state = const AsyncData(null);
+  }
+}
+```
+
+---
+
+## 6. 状态管理检查清单
+
+- [ ] 状态按生命周期和作用域正确拆分
+- [ ] 没有存储可计算的派生数据
+- [ ] 状态结构扁平化，避免深层嵌套
+- [ ] 异步操作有 loading/error 状态
+- [ ] 使用选择器（Selectors）优化渲染
+- [ ] 状态更新通过统一的 actions/mutations
+- [ ] 持久化状态有明确的持久化策略
+
+## 与其他技能的衔接
+
+- **配合**：code-split-spec、data-fetching
+- **参考**：sdd-code、test-driven-development

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

@@ -70,3 +70,43 @@
 - 核心功能必须编写单元测试
 - 测试覆盖率目标 > 80%
 - 测试用例描述要清晰
+
+---
+
+## 7. 架构与拆分规范
+
+### 7.1 代码拆分原则
+- 单一职责：每个文件/模块/函数只负责一件事
+- 高内聚低耦合：相关逻辑放一起，模块间依赖最小化
+- 粒度适中：避免过度拆分或拆分不足
+
+### 7.2 目录结构规范
+- 按业务域/功能模块组织代码
+- 分层清晰：表现层、业务层、数据层分离
+- 共享代码放统一位置
+
+### 7.3 组件/模块设计
+- 可复用优先：考虑未来复用场景
+- 接口简洁：对外提供清晰的 API
+- 依赖注入：便于测试和扩展
+
+### 7.4 状态管理
+- 最小化状态：只存储必要的源数据
+- 单一数据源：避免状态重复
+- 单向数据流：便于追踪状态变化
+
+---
+
+## 8. 代码审查规范
+
+### 8.1 审查要点
+- 功能正确性：是否符合需求
+- 代码质量：命名、结构、可读性
+- 架构设计：是否符合架构规范
+- 安全考虑：有无安全隐患
+- 测试覆盖：是否有对应测试
+
+### 8.2 审查反馈
+- 具体明确：指出问题位置和原因
+- 建设性：提供改进建议
+- 尊重他人：对事不对人

package/bin.js

@@ -6,7 +6,7 @@ const fs = require('fs');
 const path = require('path');
 
 const SDD = {
-  version: '5.0.3',
+  version: '5.0.5',
   name: 'sdd-full',
   description: '完整的软件设计开发技能包'
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-full",
-  "version": "5.0.3",
+  "version": "5.0.5",
   "description": "SDD Full - 完整的软件设计开发技能包",
   "main": "index.js",
   "bin": "./bin.js",