ai-proj-helper/skills-dev/dev-plugin/skills/SKILL.md

name, description

name	description
dev	软件开发技能组入口。整合架构设计(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 进行任务管理：

快速开始

# 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 "实现说明"

任务分解

# 创建主任务
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 后端

# 构建
make build

# 运行
./_output/main --config ./configs/config.yaml

# 测试
make test
make cover

Vue 前端

# 开发
npm run dev

# 构建
npm run build:prod

# 检查
npm run lint:eslint

React 前端

# 开发
npm start

# 构建
npm run build

# 测试
npm test
npm run test:e2e

iOS

# 构建
xcodebuild -scheme ProjectName -configuration Debug

# 测试
xcodebuild test -scheme ProjectName

Android

# 构建
./gradlew assembleDebug
./gradlew assembleRelease

# 测试
./gradlew test
./gradlew connectedAndroidTest

---

Git 工作流

提交规范

类型	说明
feat	新功能
fix	Bug 修复
docs	文档
refactor	重构
test	测试
chore	杂项

分支策略

# 功能开发
git checkout -b feature/功能名称

# 提交
git commit -m "feat: 功能描述"

# 推送
git push origin feature/功能名称

# 合并
git checkout main
git merge feature/功能名称

双电脑同步 (au-dev / cn-dev)

# 离开时
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 部署

标准配置

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