Add cc-switch-dev-workflow skill
这个提交包含在:
@@ -0,0 +1,52 @@
|
||||
# Orchestration: Agent Handoff Contract
|
||||
|
||||
## Purpose
|
||||
统一 agent 之间交接任务时的最小契约,防止交接变成全文转发。
|
||||
|
||||
## When to Use
|
||||
- 一个 agent 的输出要交给另一个 agent 时
|
||||
- 线程 reset 前
|
||||
- 从 fallback 模型回到主线程时
|
||||
|
||||
## Inputs
|
||||
- 上一角色的高密度产物
|
||||
- 当前任务边界
|
||||
- 当前任务验证方式
|
||||
|
||||
## Outputs
|
||||
- 标准化 handoff 文档
|
||||
- 可直接执行的单任务上下文
|
||||
|
||||
## Primary Agent/Model
|
||||
发起 handoff 的当前 agent
|
||||
|
||||
## Secondary Agent/Model
|
||||
接收 handoff 的下一角色 agent
|
||||
|
||||
## Required Skills
|
||||
- [`../templates/agent-handoff-template.md`](../templates/agent-handoff-template.md)
|
||||
|
||||
## Steps
|
||||
1. 用模板填好 `Goal / Scope / Non-Goals / Source of Truth / Constraints / Deliverable / Validation / Escalation`。
|
||||
2. 只引用必要文件和必要章节。
|
||||
3. 删除旧讨论、废弃方案和非本任务噪音。
|
||||
4. 接收方在执行前复述边界,如边界不清立即打回。
|
||||
|
||||
## Exit Criteria
|
||||
- 接收方无需阅读原线程即可开始执行
|
||||
- 交接文档足够短,但不缺关键边界
|
||||
|
||||
## Failure Recovery
|
||||
- 如果接收方提出“我还需要看完整聊天记录”,说明 handoff 失败,应重写
|
||||
- 如果 handoff 把实现细节和设计决策混在一起,先拆成计划与实施两个 handoff
|
||||
|
||||
## Related Templates
|
||||
- [`../templates/agent-handoff-template.md`](../templates/agent-handoff-template.md)
|
||||
|
||||
## Contract Rules
|
||||
- `Goal` 只能有一个主目标
|
||||
- `Scope` 必须点名路径、模块或文档
|
||||
- `Non-Goals` 必须明确写出这轮不要碰什么
|
||||
- `Source of Truth` 只能列真正约束当前任务的文件
|
||||
- `Validation` 必须可执行,不能写成“看起来没问题”
|
||||
- `Escalation` 必须说明什么情况停下来找人
|
||||
@@ -0,0 +1,77 @@
|
||||
# Orchestration: CC Switch Operating Model
|
||||
|
||||
## Purpose
|
||||
定义 `CC Switch` 作为主编排层时的角色分工、并行规则、reset 规则和人工接管点。
|
||||
|
||||
## When to Use
|
||||
- 配置新的多 agent 开发流程时
|
||||
- 需要并行研究、计划、实现、审查时
|
||||
- 需要明确谁负责推进主线程时
|
||||
|
||||
## Inputs
|
||||
- 当前阶段目标
|
||||
- 已批准的高密度产物
|
||||
- 当前任务优先级
|
||||
|
||||
## Outputs
|
||||
- 角色分工
|
||||
- 并行策略
|
||||
- reset 与接管规则
|
||||
|
||||
## Primary Agent/Model
|
||||
主控 agent + `GPT-5.4 Pro xhigh`
|
||||
|
||||
## Secondary Agent/Model
|
||||
审查 agent + `Claude Opus 4.6`
|
||||
|
||||
## Required Skills
|
||||
- 阶段相关 skill
|
||||
- [`../templates/agent-handoff-template.md`](../templates/agent-handoff-template.md) 所定义的 handoff 结构
|
||||
|
||||
## Steps
|
||||
1. 主控 agent 先定义阶段目标、输入输出、角色分工。
|
||||
2. 研究 agent 并行收集事实,但不直接实施。
|
||||
3. 计划 agent 把事实压缩成 `ANALYSIS.md`、Spec 或 `.plans/*.md`。
|
||||
4. 实现 agent 只读取已批准产物做执行。
|
||||
5. 审查 agent 对关键产物做第二视角复核。
|
||||
6. 每个阶段结束后 reset,只把高密度产物传到下一阶段。
|
||||
|
||||
## Exit Criteria
|
||||
- 当前阶段的 agent 角色明确
|
||||
- handoff 边界明确
|
||||
- 不存在把完整聊天记录直接转交给下个 agent 的行为
|
||||
|
||||
## Failure Recovery
|
||||
- 如果多个 agent 同时修改范围和目标,回到主控 agent 重发边界
|
||||
- 如果实现 agent开始补规则,暂停并回到计划 agent
|
||||
|
||||
## Related Templates
|
||||
- [`../templates/agent-handoff-template.md`](../templates/agent-handoff-template.md)
|
||||
- [`../templates/analysis-template.md`](../templates/analysis-template.md)
|
||||
|
||||
## Agent Roles
|
||||
|
||||
| 角色 | 主要职责 | 默认模型 |
|
||||
|---|---|---|
|
||||
| 主控 agent | 推进阶段、分配角色、控制边界、决定 reset | `GPT-5.4 Pro xhigh` |
|
||||
| 研究 agent | 读会议、读参考、读技能、读现状 | `Claude Opus 4.6` 或 `GPT-5.4 Pro xhigh` |
|
||||
| 计划 agent | 输出 `ANALYSIS.md`、`TODO.yaml`、Spec、Plan | `GPT-5.4 Pro xhigh` |
|
||||
| 实现 agent | 按计划改代码、补测试、执行任务 | `GPT-5.4 Pro xhigh` |
|
||||
| 审查 agent | 做 Spec 审查、一致性检查、第二视角复核 | `Claude Opus 4.6` |
|
||||
|
||||
## Parallel Rules
|
||||
- 可并行:独立参考主题调研、独立 Spec 草稿、独立模块 Gap 分析
|
||||
- 不可并行:同一文件的最终定稿、同一范围的多个实现 agent 同时执行
|
||||
- 并行结果必须先回计划 agent 压缩,再交给实现 agent
|
||||
|
||||
## Reset Rules
|
||||
- `Research -> Spec`
|
||||
- `Spec 审查完成 -> Code`
|
||||
- 每轮 `fallback` 结束后
|
||||
- 任何上下文已掺入过多废弃方案时
|
||||
|
||||
## Human Takeover Points
|
||||
- 选择产品范围和成功标准
|
||||
- 审核 `SPECS/*.md`
|
||||
- 批准栈例外、模型例外和 ADR
|
||||
- 最终 Acceptance
|
||||
在新工单中引用
屏蔽一个用户