mcpField
T
team-iterdev

team-iterdev

github.com/catlog22开发2.1k45 次安装19 周前更新
代码仓库

关于 team-iterdev

team-iterdev 是用于迭代式团队开发的工作流技能,协调者根据任务动态选择流水线,并跟踪实时进度。开发者与评审者可进行最多 3 轮生成—批评循环,并共享跨任务经验。

主要功能

  1. 01动态选择开发流水线
  2. 02开发者与评审者迭代循环
  3. 03实时任务进度台账
  4. 04跨迭代共享经验

适用场景

  1. 01将开发任务拆分为可迭代步骤
  2. 02跟踪团队任务进度
  3. 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.md
roles/coordinator/
role.md
roles/coordinator/commands/
analyze.md
dispatch.md
monitor.md
roles/developer/
role.md
roles/reviewer/
role.md
roles/tester/
role.md
specs/
pipelines.md
team-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)

角色注册表

角色路径前缀内部循环
coordinatorroles/coordinator/role.md——
architectroles/architect/role.mdDESIGN-*false
developerroles/developer/role.mdDEV-*true
testerroles/tester/role.mdVERIFY-*false
reviewerroles/reviewer/role.mdREVIEW-*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

规范参考

错误处理

情况解决方法
未知命令显示可用命令列表并报错
未找到角色显示角色注册表并报错
GC 循环超过 3 轮发出警告后接受,并记录到共享记忆中
冲刺速度降至 50% 以下协调者提醒用户并建议缩减范围
任务台账损坏根据 TaskList 状态重建
检测到冲突更新 conflict_info,通知协调者,并创建 DEV-fix 任务
流水线死锁检查 blockedBy 链,并报告阻塞点

评论

支持 Markdown