refactor: 通用技能按类别拆分为独立目录

skills/ → skills-dev(9), skills-req(10), skills-ops(4), skills-integration(8), skills-biz(4), skills-workflow(7) generate-marketplace.py 改为自动扫描所有 skills-* 目录。 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-14 11:31:58 +10:30
parent ea266e9cce
commit 712063071c
170 changed files with 341 additions and 346 deletions
--- a/skills-req/req-dev-plugin/README.md
+++ b/skills-req/req-dev-plugin/README.md
@@ -0,0 +1,193 @@
+# req-dev Skill
+
+需求开发计划编写技能 - 从 PRD 到代码实现的桥梁
+
+## 快速开始
+
+### 使用方式
+
+```bash
+# 方式1: 通过 req 命令调用（推荐）
+/req doc REQ-20260126-0008
+
+# 方式2: 直接调用 skill
+/req-dev REQ-20260126-0008
+```
+
+## 核心功能
+
+### 1. PRD 分析
+- 自动提取功能点和技术要求
+- 识别改动范围（前端/后端/数据库）
+
+### 2. 代码库智能探索
+- 使用 Task(Explore) 搜索相关代码
+- 定位需要修改的文件
+- 分析现有实现模式
+
+### 3. 分层架构引导
+
+**Go 后端**：
+```
+Model → Repository → Service → Handler → Route → Migration
+```
+
+**React 前端**：
+```
+Types → Services → Components → Pages → Router
+```
+
+### 4. 自动任务拆分
+- 根据修改文件自动拆分子任务
+- 每个子任务对应一个模块或文件
+- 使用 `mcp__ai-proj__create_subtask` 创建
+
+### 5. 完整开发文档
+生成包含以下内容的开发计划：
+- 需求概述
+- 代码库分析
+- 技术方案设计
+- 开发任务拆分
+- 实施顺序
+- 技术风险评估
+- 测试策略
+
+## 输出示例
+
+```markdown
+# [需求标题] 开发计划
+
+## 1. 需求概述
+- 需求编号：REQ-20260126-0008
+- 功能点清单
+- 技术要求
+
+## 2. 代码库分析
+| 文件 | 层级 | 是否修改 | 改动类型 |
+|------|------|----------|---------|
+| backend/models/manual.go | Model | ❌ 无需修改 | - |
+| backend/handlers/manual_handler.go | Handler | ✅ 需修改 | 新增接口 |
+| frontend/src/pages/ManualListPage.tsx | Page | ✅ 需修改 | 新增功能 |
+
+## 3. 技术方案设计
+### 3.1 后端改动（Go）
+- Model 层：数据结构
+- Repository 层：数据访问
+- Service 层：业务逻辑
+- Handler 层：HTTP 处理
+- Route 层：路由注册
+
+### 3.2 前端改动（React）
+- Types：类型定义
+- Services：API 服务
+- Components：组件开发
+- Pages：页面修改
+
+## 4. 开发任务拆分
+├── [Model] 修改 manual.go
+├── [Handler] 修改 manual_handler.go
+├── [Page] 修改 ManualListPage.tsx
+└── [Test] 添加单元测试
+
+## 5. 技术风险评估
+...
+```
+
+## 与其他技能的配合
+
+| 技能 | 使用场景 | 配合方式 |
+|------|----------|---------|
+| req-prd | PRD 编写 | req-dev 基于 req-prd 生成的 PRD 进行分析 |
+| dev-arch | 系统架构设计 | 大重构时先用 dev-arch 设计，再用 req-dev 实施 |
+| dev-coding | 编码实现 | req-dev 生成计划后，dev-coding 执行编码 |
+| dev-test | 测试 | req-dev 生成测试策略，dev-test 执行测试 |
+
+## 工作流程
+
+```
+1. 获取需求信息（PRD 文档、关联任务）
+   ↓
+2. 分析 PRD，提取功能点
+   ↓
+3. 探索代码库（Task Explore）
+   ↓
+4. 生成技术方案（分层架构）
+   ↓
+5. 拆分开发子任务
+   ↓
+6. 生成开发计划文档
+   ↓
+7. 评估技术风险
+```
+
+## 最佳实践
+
+### 1. 充分探索代码库
+- 先精确搜索，再模糊搜索
+- 识别可复用的代码模式
+- 分析现有依赖关系
+
+### 2. 合理拆分任务
+- 按 2-4 小时粒度拆分
+- 每个任务对应一个文件或模块
+- 遵循 SMART 原则
+
+### 3. 评估技术风险
+- 数据库影响（Migration、索引）
+- API 兼容性（版本管理）
+- 性能影响（查询复杂度、缓存）
+- 业务风险（核心流程、回退方案）
+
+### 4. 按分层架构开发
+- 后端：Model → Repository → Service → Handler → Route
+- 前端：Types → Services → Components → Pages
+- 先下层，后上层（依赖关系）
+
+## 常见问题
+
+### Q: req-dev 和 dev-arch 有什么区别？
+**A**:
+- **dev-arch**：系统级架构设计（新系统、大重构）
+- **req-dev**：功能级实现规划（需求开发、小改动）
+
+### Q: 什么时候需要创建子任务？
+**A**:
+- 需要修改 3 个以上文件
+- 预估总工时 > 4 小时
+- 涉及多个层级（Model + Service + Handler）
+
+### Q: 如何确保开发文档质量？
+**A**:
+- 基于真实代码探索（不猜测）
+- 提供具体文件路径和代码示例
+- 评估技术风险和性能影响
+- 给出清晰的实施顺序
+
+## 技术栈支持
+
+### 后端
+- ✅ Go + Gin + GORM（ai-proj 项目）
+- ⚠️ 其他技术栈需要调整分层架构
+
+### 前端
+- ✅ React + TypeScript + Ant Design（ai-proj 项目）
+- ⚠️ 其他技术栈需要调整目录结构
+
+### 数据库
+- ✅ PostgreSQL + Migration（ai-proj 项目）
+
+## 更新日志
+
+- **V1.0** (2026-01-26): 初始版本
+  - 支持 Go 后端分层架构
+  - 支持 React 前端架构
+  - 自动任务拆分
+  - 代码库智能探索
+  - 技术风险评估
+
+## 相关文档
+
+- [SKILL.md](./SKILL.md) - 完整技能文档
+- [req SKILL.md](../req/SKILL.md) - 需求管理流程
+- [req-prd SKILL.md](../req-prd/SKILL.md) - PRD 编写
+- [CLAUDE.md](../../../CLAUDE.md) - 项目说明