# ai-dev-workflow

**Repository Path**: daimiaoyige/ai-dev-workflow

## Basic Information

- **Project Name**: ai-dev-workflow
- **Description**: AI开发工作流技能 - 多项目任务管理 + 远程Claude Code开发
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-17
- **Last Updated**: 2026-06-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: ai自动化, AI

## README

# AI Dev Workflow

> 🤖 AI开发工作流技能 - 多项目任务管理 + 远程 Claude Code / Codex CLI 开发

## 特性

- **任务管理** - `.task/` 目录管理所有任务数据，与Agent配置完全解耦
- **远程开发** - 通过SSH驱动远程 Claude Code 或 Codex CLI 执行任务
- **开发规划** - 基于服务边界的任务拆分，生成一服务一Prompt
- **CLI指令参考** - 完整的 acpx/Claude CLI 与 Codex CLI 指令手册
- **验证闭环** - 命令测试、接口验证、Chrome/Playwright 网页验收和报告留证
- **模板 & Agent参考** - 需求模板、任务模板、Agent选择指南

## 目录结构

```
ai-dev-workflow/
├── AGENTS.md                   # Codex CLI 仓库级指令
├── SKILL.md                    # 技能主入口
├── task-manager.md             # 能力一：任务管理
├── remote-dev.md              # 能力二：远程开发
├── planner.md                 # 能力三：开发规划
├── claude-code-usage.md       # 能力四：Claude Code指令
├── codex-cli-usage.md         # 能力五：Codex CLI兼容
├── validation.md              # 能力六：验证闭环
├── agent-ref.md              # Agent参考指南
├── config.yml                # 远程服务器配置
├── scripts/                  # 仓库自检脚本
│   ├── validate-skill.ps1
│   └── validate-skill.sh
├── templates/                # 模板目录
│   ├── req-template.md
│   ├── task-template.md
│   ├── project-claude-template.md
│   ├── project-agents-template.md
│   ├── verification-report-template.md
│   ├── service-map-template.md
│   └── memory-template.md
└── init/                    # 项目初始化文档
    └── example-web-app/
        └── CLAUDE.md
```

## 快速开始

### 1. 安装

#### Claude Code Skill

将 `ai-dev-workflow` 目录复制到你的 `.claude/skills/` 目录下：

```bash
# 在项目根目录执行
mkdir -p .claude/skills/
# 复制 ai-dev-workflow 目录到此处
```

#### Codex CLI Skill

将 `ai-dev-workflow` 目录复制到你的 `~/.codex/skills/` 目录下：

```bash
mkdir -p ~/.codex/skills/
cp -r ai-dev-workflow ~/.codex/skills/ai-dev-workflow
```

目标项目如果要让 Codex CLI 自动读取项目规范，可复制模板：

```bash
cp ~/.codex/skills/ai-dev-workflow/templates/project-agents-template.md AGENTS.md
```

### 2. 配置远程服务器

编辑 `config.yml`：

```yaml
remote:
  host: 192.168.1.3
  port: 22
  user: xujianfeng
  ssh_key: ~/.ssh/id_rsa

workspace:
  root: /home/xujianfeng/projects  # 包含多个项目的工作空间
```

### 3. 创建任务数据目录

```bash
mkdir -p .task/SPEC
mkdir -p .task/memory
mkdir -p .task/verification
```

## 核心工作流

```
用户给需求
    ↓
任务管理：检查 MEMORY.md、读取需求文档
    ↓
开发规划：拆解需求、生成Prompt（三级拆分策略）
    ↓
用户确认计划
    ↓
选择执行器：Claude Code/acpx 或 Codex CLI
    ↓
远程/本地 Agent 执行（长会话保持上下文）
    ↓
验证闭环：测试/API/Chrome验证 + 证据报告
    ↓
任务管理：更新MEMORY.md、标记需求状态
```

## 六大能力

### 能力一：任务管理

`.task/` 目录包含所有任务数据：

- `MEMORY.md` - 项目状态总表
- `SPEC/req-*.md` - 需求文档
- `SPEC/service_map.md` - 服务地图
- `memory/` - 每日记忆

### 能力二：远程开发

通过SSH连接远程服务器，用 acpx 控制 Claude Code，或直接调用 Codex CLI：

```bash
# Claude Code 短任务
ssh user@host "acpx claude exec '任务描述'"

# Claude Code 长任务（推荐）
ssh user@host "acpx claude -s <session_id> prompt -f /tmp/task.md"

# Codex CLI 短任务
ssh user@host "cd /path/to/project && codex exec '任务描述'"

# Codex CLI 文件任务
ssh user@host "cd /path/to/project && codex exec - < /tmp/task.md"
```

### 能力三：开发规划

三级拆分策略：

| Tier | 触发条件 | 模式 |
|------|----------|------|
| Tier 1 | 有源码 | 源码级精准模式 |
| Tier 2 | 无源码但有service_map | 契约精准推演模式 |
| Tier 3 | 全新服务 | 纯盲写拓荒模式 |

### 能力四：Claude Code指令

```bash
claude               # 交互式开发
claude -p "任务"      # 非交互式执行
claude -c            # 继续最近会话
claude init          # 初始化项目
claude --version     # 查看版本
```

### 能力五：Codex CLI兼容

```bash
codex -C /path/to/project                         # 交互式开发
codex exec -C /path/to/project "任务描述"          # 非交互执行
codex review --uncommitted                        # 审查未提交改动
codex resume --last                               # 恢复最近会话
```

### 能力六：验证闭环

```bash
# 命令验证
<lint command>
<test command>
<build command>

# 网页/Chrome验证（Playwright CLI）
export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export PWCLI="$CODEX_HOME/skills/playwright/scripts/playwright_cli.sh"
"$PWCLI" open http://127.0.0.1:3000 --headed
"$PWCLI" snapshot
"$PWCLI" console warning
"$PWCLI" network
"$PWCLI" screenshot
```

## 模板

使用模板快速创建文档：

```bash
# 创建需求文档
cp .claude/skills/ai-dev-workflow/templates/req-template.md .task/SPEC/req-001-xxx.md

# 创建任务文件
cp .claude/skills/ai-dev-workflow/templates/task-template.md /tmp/task.md

# 创建 Codex CLI 项目指令
cp ~/.codex/skills/ai-dev-workflow/templates/project-agents-template.md AGENTS.md

# 创建验证报告
cp ~/.codex/skills/ai-dev-workflow/templates/verification-report-template.md .task/verification/req-001/report.md

# 创建每日记忆
cp ~/.codex/skills/ai-dev-workflow/templates/memory-template.md .task/memory/2026-06-03.md
```

## 示例

### 查看项目进度

```bash
cat .task/MEMORY.md
ls .task/SPEC/
```

### 发送远程任务

```bash
# 1. 写任务文件
cat > /tmp/task.md << 'EOF'
# 任务：实现用户认证

## 具体要求
1. 添加 JWT 验证
2. 实现登录接口
EOF

# 2. 上传到远程
scp /tmp/task.md user@host:/tmp/

# 3. 发送执行（Claude Code）
ssh user@host "cd /path/to/project && acpx claude -s <id> prompt -f /tmp/task.md"

# 或发送执行（Codex CLI）
ssh user@host "cd /path/to/project && codex exec - < /tmp/task.md"
```

### 网页验证示例

```bash
# 1. 启动目标项目
npm run dev -- --host 127.0.0.1

# 2. 用真实 Chrome/Playwright 验证
export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export PWCLI="$CODEX_HOME/skills/playwright/scripts/playwright_cli.sh"
"$PWCLI" open http://127.0.0.1:3000 --headed
"$PWCLI" snapshot
"$PWCLI" console warning
"$PWCLI" network
"$PWCLI" screenshot
```

### Skill 自检

```powershell
# Windows PowerShell
powershell -ExecutionPolicy Bypass -File .\scripts\validate-skill.ps1

# Linux / macOS
bash scripts/validate-skill.sh
```

## 依赖

- SSH访问远程服务器（远程执行时需要）
- acpx 已安装并配置（使用 Claude Code 远程执行时需要）
- Claude Code 已安装（使用 Claude 执行器时需要）
- Codex CLI 已安装（使用 Codex 执行器时需要）
- Node.js/npm 与 Playwright CLI（网页 Chrome 验证时需要）

## License

MIT