长时自动化编程系统 v3.0 - 集成 superpowers skills 实现高质量自动化开发。
ACoder 是一个编排层系统，通过调用 superpowers skills 实现自动化编程：
┌─────────────────────────────────────────────────────────────────┐
│ acoder (编排层) │
│ • 项目管理（创建、状态、进度） │
│ • 会话持久化（session_state） │
│ • 分支管理 │
│ • 命令路由 │
└───────────────────────────────┬─────────────────────────────────┘
│ 调用
▼
┌─────────────────────────────────────────────────────────────────┐
│ superpowers skills │
│ writing-plans → subagent-driven-development │
│ verification-before-completion → systematic-debugging │
└─────────────────────────────────────────────────────────────────┘
- Markdown 任务格式: feature_list.md 提供可读性更强的任务描述
- 完整上下文: 每个任务包含背景、需求、技术设计、验收标准
- 自包含: 不引用外部文档，所有信息在一个任务内完整
- 逐个生成: 任务一个一个添加，支持增量迭代
- 分支管理 - 可选为项目创建 Git 分支
- Phases 可视化 - 按阶段展示任务进度
- 会话持久化 - 支持中断恢复
- Superpowers 集成 - 高质量子代理驱动开发
- 验证优先 - 没有验证就不能声称完成
# 创建项目（默认不创建分支）
/acoder init <项目名> "需求描述"
# 从需求文档创建
/acoder init <项目名> --from requirement.md
# 创建项目并创建分支（使用项目名作为分支名）
/acoder init <项目名> --branch "需求描述"
# 指定分支名
/acoder init <项目名> --branch custom-branch "需求描述"/acoder status <项目名># 执行一个任务
/acoder code <项目名>
# 循环执行所有任务
/acoder code <项目名> --loop
# 执行指定任务
/acoder code <项目名> <任务ID>/acoder list| 用法 | 说明 |
|---|---|
/acoder init <项目名> "需求" |
默认不创建分支，使用当前分支 |
/acoder init <项目名> --from <文件> |
从需求文档创建 |
/acoder init <项目名> --branch "需求" |
创建分支（使用项目名） |
/acoder init <项目名> --branch xxx "需求" |
自定义分支名 |
执行流程：
- 分支处理（可选创建分支，默认不创建）
- 创建项目目录结构
- 分析代码库
- 逐个生成任务（Markdown 格式，包含完整上下文）
- 保存任务列表并显示 Phases 可视化
| 用法 | 说明 |
|---|---|
/acoder code <项目名> |
执行一个任务 |
/acoder code <项目名> --loop |
循环执行所有任务 |
/acoder code <项目名> <任务ID> |
执行指定任务 |
执行流程：
- 获取下一个待完成任务
- 获取任务完整上下文（Markdown 格式）
- 更新会话状态
- 调用
superpowers:subagent-driven-development执行 - 验证完成（铁律：没有验证就不能声称完成）
- 更新任务状态（同时更新 JSON 和 Markdown）
- Git 提交
/acoder status <项目名>输出示例：
═══════════════════════════════════════════════════════════════
📊 项目状态: user-auth
═══════════════════════════════════════════════════════════════
状态: 🔄 running
分支: main
进度: 3/9 (33%)
───────────────────────────────────────────────────────────────
📋 Phases 状态
───────────────────────────────────────────────────────────────
✅ Phase 1: 基础结构 (3/3) ✓
- ✅ TASK-001: 创建用户模型
- ✅ TASK-002: 实现数据库迁移
- ✅ TASK-003: 添加配置文件
🔄 Phase 2: 认证功能 (0/4)
- ⬜ TASK-004: 实现登录接口 ← 当前
- ⬜ TASK-005: 实现注册接口
...
📄 查看完整任务列表: cat .acoder/projects/user-auth/feature_list.md
/acoder list| 用法 | 说明 |
|---|---|
/acoder task list <项目名> |
列出所有任务 |
/acoder task add <项目名> <ID> <描述> |
添加任务（简单格式） |
/acoder task context <项目名> <任务ID> |
获取任务完整上下文 |
/acoder task complete <项目名> <任务ID> |
标记完成 |
/acoder review <项目名>.acoder/
└── projects/
└── <项目名>/
├── project.json # 项目配置 + session状态 + 分支信息
├── feature_list.json # 任务列表（程序化访问）
├── feature_list.md # 任务列表（可读性更强）
├── progress.txt # 进度日志
└── logs/ # 日志目录
每个任务包含完整上下文：
## TASK-001: 任务标题
**状态**: ⬜ 待完成 / ✅ 已完成
### 背景 (Background)
{为什么存在这个任务，解决什么问题}
### 需求 (Requirements)
{具体要实现什么功能}
### 技术设计 (Technical Design)
{如何实现：架构、模式、代码结构}
### 验收标准 (Acceptance Criteria)
{可测试的完成标准}
### 影响文件 (Files Affected)
- `path/to/file.ext`
### 依赖 (Dependencies)
- TASK-XXX (如果有的话)python3 ~/.claude/skills/acoder/acoder.py <命令> [参数]| 命令 | 说明 |
|---|---|
create <项目名> [--branch [分支名]] |
创建项目（默认不创建分支） |
load <项目名> |
加载项目信息 |
list |
列出所有项目 |
next-task <项目名> |
获取下一个任务 |
update-task <项目名> <ID> <true|false> |
更新任务状态 |
add-task-md <项目名> <ID> <标题> [--bg] [--req] [--tech] [--accept] [--files] |
添加任务（Markdown） |
task-context <项目名> <任务ID> |
获取任务完整上下文 |
save-features <项目名> '<JSON>' |
保存功能列表 |
session <项目名> |
获取/更新会话状态 |
phases <项目名> |
获取 phases 状态 |
is-complete <项目名> |
检查项目是否完成 |
- 验证优先 - 没有验证就不能声称完成
- 增量进度 - 每次只处理一个任务
- 子代理驱动 - 每个任务新的上下文
- 两阶段审查 - 规格 → 质量
- 自包含任务 - 每个任务包含完整上下文
配置文件: ~/.claude/skills/acoder/config.json
{
"auto_detect_paths": true,
"auto_commit": true,
"default_priority": "medium",
"max_iterations": 100
}