move claude-marketplace to ai-proj-helper
This commit is contained in:
314
plugins/dev-plugin/skills/SKILL.md
Normal file
314
plugins/dev-plugin/skills/SKILL.md
Normal file
@@ -0,0 +1,314 @@
|
||||
---
|
||||
name: dev
|
||||
description: 软件开发技能组入口。整合架构设计(dev-arch)、编码实现(dev-coding)、测试(dev-test)三个子技能，提供完整的软件开发工作流。支持全栈开发：Go、Vue、React、iOS、Android、小程序等。
|
||||
---
|
||||
|
||||
# 软件开发 Skill (dev)
|
||||
|
||||
## 概述
|
||||
|
||||
dev 是一个技能组入口，整合了软件开发的三个核心阶段：
|
||||
|
||||
| 子技能 | 用途 | 触发词 |
|
||||
|--------|------|--------|
|
||||
| **dev-arch** | 架构设计、技术选型、系统设计 | 架构、设计、技术方案 |
|
||||
| **dev-coding** | 编码实现、功能开发、代码审查 | 编码、开发、实现 |
|
||||
| **dev-test** | 单元测试、集成测试、E2E测试 | 测试、test、覆盖率 |
|
||||
|
||||
---
|
||||
|
||||
## 开发工作流
|
||||
|
||||
```
|
||||
需求分析 → 架构设计 → 编码实现 → 测试验证 → 部署上线
|
||||
↓ ↓ ↓
|
||||
dev-arch dev-coding dev-test
|
||||
```
|
||||
|
||||
### 典型流程
|
||||
|
||||
1. **架构设计** (dev-arch)
|
||||
- 需求分析
|
||||
- 技术选型
|
||||
- 系统设计文档
|
||||
- 架构评审
|
||||
|
||||
2. **编码实现** (dev-coding)
|
||||
- 任务分解
|
||||
- 功能开发
|
||||
- 代码审查
|
||||
- 文档记录
|
||||
|
||||
3. **测试验证** (dev-test)
|
||||
- 单元测试
|
||||
- 集成测试
|
||||
- E2E 测试
|
||||
- 覆盖率分析
|
||||
|
||||
---
|
||||
|
||||
## 支持的项目类型
|
||||
|
||||
### 当前项目生态
|
||||
|
||||
| 项目 | 类型 | 技术栈 |
|
||||
|------|------|--------|
|
||||
| **TWMS** | 仓储物流 | Go + Vue 3 + MySQL |
|
||||
| **AI-Proj** | 项目管理 | Go + React + PostgreSQL + iOS + Android |
|
||||
| **DICIAI** | 进销存SaaS | Go + Vue 3 + MySQL + Android PDA |
|
||||
|
||||
### 技术栈矩阵
|
||||
|
||||
| 端 | 语言/框架 | 工具 |
|
||||
|-----|----------|------|
|
||||
| **后端** | Go (Gin + GORM) | MySQL/PostgreSQL, Redis, Docker |
|
||||
| **Web前端** | Vue 3 / React 18 | TypeScript, Vite/CRA, Ant Design |
|
||||
| **iOS** | Swift + SwiftUI | Xcode, XCTest |
|
||||
| **Android** | Kotlin + Compose | Gradle, Hilt, Room |
|
||||
| **PDA** | Android 原生 | 扫码枪集成, 离线存储 |
|
||||
| **MCP** | TypeScript | Node.js, MCP SDK |
|
||||
|
||||
---
|
||||
|
||||
## ai-proj 任务管理集成
|
||||
|
||||
所有开发工作都通过 ai-proj CLI 进行任务管理：
|
||||
|
||||
### 快速开始
|
||||
|
||||
```bash
|
||||
# 1. 查看待办任务
|
||||
ai-proj task list --status in_progress,todo
|
||||
|
||||
# 2. 启动任务
|
||||
ai-proj task start --id <taskId>
|
||||
|
||||
# 3. 完成任务
|
||||
ai-proj task complete --id <taskId>
|
||||
|
||||
# 4. 记录文档
|
||||
ai-proj task append-doc --id <taskId> --content "实现说明"
|
||||
```
|
||||
|
||||
### 任务分解
|
||||
|
||||
```bash
|
||||
# 创建主任务
|
||||
ai-proj task create --title "功能名称"
|
||||
|
||||
# 创建子任务
|
||||
ai-proj task create --title "架构设计" --parent-id <parentId>
|
||||
ai-proj task create --title "功能开发" --parent-id <parentId>
|
||||
ai-proj task create --title "测试验证" --parent-id <parentId>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 常用命令速查
|
||||
|
||||
### Go 后端
|
||||
|
||||
```bash
|
||||
# 构建
|
||||
make build
|
||||
|
||||
# 运行
|
||||
./_output/main --config ./configs/config.yaml
|
||||
|
||||
# 测试
|
||||
make test
|
||||
make cover
|
||||
```
|
||||
|
||||
### Vue 前端
|
||||
|
||||
```bash
|
||||
# 开发
|
||||
npm run dev
|
||||
|
||||
# 构建
|
||||
npm run build:prod
|
||||
|
||||
# 检查
|
||||
npm run lint:eslint
|
||||
```
|
||||
|
||||
### React 前端
|
||||
|
||||
```bash
|
||||
# 开发
|
||||
npm start
|
||||
|
||||
# 构建
|
||||
npm run build
|
||||
|
||||
# 测试
|
||||
npm test
|
||||
npm run test:e2e
|
||||
```
|
||||
|
||||
### iOS
|
||||
|
||||
```bash
|
||||
# 构建
|
||||
xcodebuild -scheme ProjectName -configuration Debug
|
||||
|
||||
# 测试
|
||||
xcodebuild test -scheme ProjectName
|
||||
```
|
||||
|
||||
### Android
|
||||
|
||||
```bash
|
||||
# 构建
|
||||
./gradlew assembleDebug
|
||||
./gradlew assembleRelease
|
||||
|
||||
# 测试
|
||||
./gradlew test
|
||||
./gradlew connectedAndroidTest
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Git 工作流
|
||||
|
||||
### 提交规范
|
||||
|
||||
| 类型 | 说明 |
|
||||
|------|------|
|
||||
| feat | 新功能 |
|
||||
| fix | Bug 修复 |
|
||||
| docs | 文档 |
|
||||
| refactor | 重构 |
|
||||
| test | 测试 |
|
||||
| chore | 杂项 |
|
||||
|
||||
### 分支策略
|
||||
|
||||
```bash
|
||||
# 功能开发
|
||||
git checkout -b feature/功能名称
|
||||
|
||||
# 提交
|
||||
git commit -m "feat: 功能描述"
|
||||
|
||||
# 推送
|
||||
git push origin feature/功能名称
|
||||
|
||||
# 合并
|
||||
git checkout main
|
||||
git merge feature/功能名称
|
||||
```
|
||||
|
||||
### 双电脑同步 (au-dev / cn-dev)
|
||||
|
||||
```bash
|
||||
# 离开时
|
||||
git add -A
|
||||
git commit -m "WIP: sync from $(hostname)"
|
||||
git push origin $(git branch --show-current)
|
||||
|
||||
# 到达时
|
||||
git fetch origin
|
||||
git pull origin $(git branch --show-current)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Docker 部署
|
||||
|
||||
### 标准配置
|
||||
|
||||
```yaml
|
||||
services:
|
||||
backend:
|
||||
build: ./backend
|
||||
ports:
|
||||
- "8080:8080"
|
||||
depends_on:
|
||||
- db
|
||||
- redis
|
||||
|
||||
frontend:
|
||||
build: ./frontend
|
||||
ports:
|
||||
- "80:80"
|
||||
|
||||
db:
|
||||
image: mysql:8.0
|
||||
# 或 postgres:15
|
||||
|
||||
redis:
|
||||
image: redis:alpine
|
||||
```
|
||||
|
||||
### 常用端口
|
||||
|
||||
| 服务 | 端口 |
|
||||
|------|------|
|
||||
| Backend | 8080 / 9099 |
|
||||
| Frontend | 80 / 3000 |
|
||||
| MySQL | 3306 |
|
||||
| PostgreSQL | 5432 |
|
||||
| Redis | 6379 |
|
||||
|
||||
---
|
||||
|
||||
## 子技能详情
|
||||
|
||||
### dev-arch (架构设计)
|
||||
|
||||
用于系统设计阶段：
|
||||
- 需求分析
|
||||
- 技术选型
|
||||
- 架构设计文档
|
||||
- API 设计
|
||||
- 数据库设计
|
||||
- 架构评审
|
||||
|
||||
### dev-coding (编码实现)
|
||||
|
||||
用于开发实现阶段：
|
||||
- Go 后端开发
|
||||
- Vue/React 前端开发
|
||||
- iOS/Android 移动开发
|
||||
- PDA 应用开发
|
||||
- MCP 桥接开发
|
||||
- 代码审查
|
||||
|
||||
### dev-test (测试)
|
||||
|
||||
用于测试验证阶段：
|
||||
- 单元测试
|
||||
- 集成测试
|
||||
- E2E 测试
|
||||
- UI 测试
|
||||
- 覆盖率分析
|
||||
|
||||
---
|
||||
|
||||
## 最佳实践
|
||||
|
||||
1. **任务驱动** - 使用 ai-proj 管理所有开发任务
|
||||
2. **设计先行** - 复杂功能先设计后编码
|
||||
3. **分层清晰** - Controller → Service → Repository
|
||||
4. **小步提交** - 频繁提交，每次做一件事
|
||||
5. **测试覆盖** - 核心逻辑必须有测试
|
||||
6. **文档同步** - 代码变更同步更新文档
|
||||
7. **代码审查** - 重要变更必须审查
|
||||
|
||||
---
|
||||
|
||||
## 何时使用哪个子技能
|
||||
|
||||
| 场景 | 推荐技能 |
|
||||
|------|----------|
|
||||
| 新功能设计 | dev-arch |
|
||||
| 技术方案评审 | dev-arch |
|
||||
| 功能开发实现 | dev-coding |
|
||||
| Bug 修复 | dev-coding |
|
||||
| 编写测试 | dev-test |
|
||||
| 测试覆盖率提升 | dev-test |
|
||||
| 代码审查 | dev-coding |
|
||||
| 性能优化 | dev-arch + dev-coding |
|
||||
Reference in New Issue
Block a user