关于 team-iterdev
team-iterdev 是用于迭代式团队开发的工作流技能,协调者根据任务动态选择流水线,并跟踪实时进度。开发者与评审者可进行最多 3 轮生成—批评循环,并共享跨任务经验。
主要功能
- 01动态选择开发流水线
- 02开发者与评审者迭代循环
- 03实时任务进度台账
- 04跨迭代共享经验
适用场景
- 01将开发任务拆分为可迭代步骤
- 02跟踪团队任务进度
- 03通过多轮评审处理实现问题
MCP 相关
使用 `mcp__ccw-tools__team_msg` 作为团队消息总线。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ catlog22/ claude-code-workflow --skill team-iterdev安装后在 Claude Code 中输入/team-iterdev确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
roles/architect/role.mdroles/coordinator/role.mdroles/coordinator/commands/analyze.mddispatch.mdmonitor.mdroles/developer/role.mdroles/reviewer/role.mdroles/tester/role.mdspecs/pipelines.mdteam-config.json详细介绍
Team IterDev
迭代开发团队技能。生成器-批评者循环(开发者<->审查者,最多 3 轮)、任务台账(task-ledger.json),用于实时跟踪进度;共享记忆(跨冲刺学习);以及动态流水线选择,用于增量交付。
架构
Skill(skill="team-iterdev", args="task description")
|
SKILL.md (this file) = Router
|
+--------------+--------------+
| |
no --role flag --role <name>
| |
Coordinator Worker
roles/coordinator/role.md roles/<name>/role.md
|
+-- analyze -> dispatch -> spawn workers -> STOP
|
+-------+-------+-------+
v v v v
[architect] [developer] [tester] [reviewer]
(team-worker agents, each loads roles/<role>/role.md)
角色注册表
| 角色 | 路径 | 前缀 | 内部循环 |
|---|---|---|---|
| coordinator | roles/coordinator/role.md | — | — |
| architect | roles/architect/role.md | DESIGN-* | false |
| developer | roles/developer/role.md | DEV-* | true |
| tester | roles/tester/role.md | VERIFY-* | false |
| reviewer | roles/reviewer/role.md | REVIEW-* | false |
角色路由器
解析 $ARGUMENTS:
- 包含
--role <name>→ 读取roles/<name>/role.md,执行 Phase 2-4 - 不包含
--role→@roles/coordinator/role.md,执行入口路由器
共享常量
- 会话前缀:
IDS - 会话路径:
.workflow/.team/IDS-<slug>-<date>/ - CLI 工具:
ccw cli --mode analysis(只读)、ccw cli --mode write(修改) - 消息总线:
mcp__ccw-tools__team_msg(session_id=<session-id>, ...)
工作人员启动模板
协调者使用此模板启动工作人员:
Agent({
subagent_type: "team-worker",
description: "Spawn <role> worker",
team_name: "iterdev",
name: "<role>",
run_in_background: true,
prompt: `## Role Assignment
role: <role>
role_spec: <skill_root>/roles/<role>/role.md
session: <session-folder>
session_id: <session-id>
team_name: iterdev
requirement: <task-description>
inner_loop: <true|false>
Read role_spec file (@<skill_root>/roles/<role>/role.md) to load Phase 2-4 domain instructions.
Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5 (report).`
})
用户命令
| 命令 | 操作 |
|---|---|
check / status | 查看执行状态图 |
resume / continue | 进入下一步 |
会话目录
.workflow/.team/IDS-<slug>-<YYYY-MM-DD>/
├── .msg/
│ ├── messages.jsonl # Team message bus
│ └── meta.json # Session state
├── task-analysis.json # Coordinator analyze output
├── task-ledger.json # Real-time task progress ledger
├── wisdom/ # Cross-task knowledge accumulation
│ ├── learnings.md
│ ├── decisions.md
│ ├── conventions.md
│ └── issues.md
├── design/ # Architect output
│ ├── design-001.md
│ └── task-breakdown.json
├── code/ # Developer tracking
│ └── dev-log.md
├── verify/ # Tester output
│ └── verify-001.json
└── review/ # Reviewer output
└── review-001.md
规范参考
- specs/pipelines.md — 流水线定义和任务注册表
错误处理
| 情况 | 解决方法 |
|---|---|
| 未知命令 | 显示可用命令列表并报错 |
| 未找到角色 | 显示角色注册表并报错 |
| GC 循环超过 3 轮 | 发出警告后接受,并记录到共享记忆中 |
| 冲刺速度降至 50% 以下 | 协调者提醒用户并建议缩减范围 |
| 任务台账损坏 | 根据 TaskList 状态重建 |
| 检测到冲突 | 更新 conflict_info,通知协调者,并创建 DEV-fix 任务 |
| 流水线死锁 | 检查 blockedBy 链,并报告阻塞点 |
评论
支持 Markdown