Add cc-switch-dev-workflow skill

这个提交包含在:
X
2026-03-26 00:27:17 -07:00
父节点 fc8ad7c145
当前提交 dcb2a10ad8
修改 46 个文件,包含 3393 行新增0 行删除

查看文件

@@ -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