Add cc-switch-dev-workflow skill
这个提交包含在：
X
@@ -0,0 +1,63 @@
|
||||
# ADR-2026-03-21 Model Routing And Fallbacks
|
||||
|
||||
## Purpose
|
||||
记录当前默认模型路由和 fallback 边界。
|
||||
|
||||
## When to Use
|
||||
- 需要决定主辅模型时
|
||||
- 需要启用 fallback 时
|
||||
|
||||
## Inputs
|
||||
- 当前阶段
|
||||
- 任务类型
|
||||
- 文档长度
|
||||
|
||||
## Outputs
|
||||
- 模型路由决策
|
||||
|
||||
## Primary Agent/Model
|
||||
项目 owner + `GPT-5.4 Pro xhigh`
|
||||
|
||||
## Secondary Agent/Model
|
||||
`Claude Opus 4.6`
|
||||
|
||||
## Required Skills
|
||||
- 无
|
||||
|
||||
## Steps
|
||||
1. 先判断任务类型。
|
||||
2. 再确定主辅模型。
|
||||
3. 若需要 fallback，先写边界，再压缩回主线程。
|
||||
|
||||
## Exit Criteria
|
||||
- 主辅模型与 fallback 路线都明确
|
||||
|
||||
## Failure Recovery
|
||||
- 若 fallback 成为默认路线，说明本 ADR 被破坏，应重新审查
|
||||
|
||||
## Related Templates
|
||||
- [`../templates/agent-handoff-template.md`](../templates/agent-handoff-template.md)
|
||||
|
||||
## Status
|
||||
Accepted
|
||||
|
||||
## Context
|
||||
- 团队需要在长文处理、复杂推演、Spec 审查和实施之间切换最合适模型。
|
||||
- 不能把临时 fallback 升级为默认主路线。
|
||||
|
||||
## Decision
|
||||
- 默认主模型：`GPT-5.4 Pro xhigh`
|
||||
- 默认辅模型：`Claude Opus 4.6`
|
||||
- `GPT-5.4 Pro xhigh` 负责研究规划、任务拆分、结构化文档、实施与重构主链路。
|
||||
- `Claude Opus 4.6` 负责长文消化、Spec 审读、第二视角复核。
|
||||
- `GLM / Minimax / Kimi` 仅作受控 fallback，不作为默认项目主链路。
|
||||
- 任何 fallback 输出都必须压缩为标准 handoff 后才能回到主线程。
|
||||
|
||||
## Consequences
|
||||
- 模型切换更可预测
|
||||
- handoff 质量变成模型协作的硬约束
|
||||
- fallback 使用频率可被审计，而不是隐形扩散
|
||||
|
||||
## Revisit When
|
||||
- 主模型能力或成本结构显著变化
|
||||
- 团队引入新的主编排系统
|
||||
@@ -0,0 +1,62 @@
|
||||
# ADR-2026-03-21 Source Precedence And Conflict Resolution
|
||||
|
||||
## Purpose
|
||||
记录 5 个源资产出现冲突时的裁决规则。
|
||||
|
||||
## When to Use
|
||||
- 两个来源对同一主题给出不同说法时
|
||||
- 要决定正式知识库采用哪一版规则时
|
||||
|
||||
## Inputs
|
||||
- 冲突条目
|
||||
- 相关源资产
|
||||
- 受影响页面
|
||||
|
||||
## Outputs
|
||||
- 冲突取舍结论
|
||||
|
||||
## Primary Agent/Model
|
||||
项目 owner + `GPT-5.4 Pro xhigh`
|
||||
|
||||
## Secondary Agent/Model
|
||||
`Claude Opus 4.6`
|
||||
|
||||
## Required Skills
|
||||
- 无
|
||||
|
||||
## Steps
|
||||
1. 列出冲突项。
|
||||
2. 判断谁更晚、更新、具体和可执行。
|
||||
3. 用结论更新正式页面。
|
||||
|
||||
## Exit Criteria
|
||||
- 冲突已收敛到单一入口
|
||||
|
||||
## Failure Recovery
|
||||
- 若正式页面仍保留冲突规则，说明 ADR 未真正落地
|
||||
|
||||
## Related Templates
|
||||
- [`../templates/analysis-template.md`](../templates/analysis-template.md)
|
||||
|
||||
## Status
|
||||
Accepted
|
||||
|
||||
## Context
|
||||
- `workflow.zip` 提供阶段骨架。
|
||||
- 两份 3 月会议整理文档提供原则和经验修正。
|
||||
- `skills.zip` 提供更细粒度的执行约束。
|
||||
|
||||
## Decision
|
||||
- 阶段骨架以 `workflow.zip` 为准。
|
||||
- 长期原则、可靠性和设计哲学，以 2026 年 3 月两份会议整理文档为准。
|
||||
- 任务结构、检查点和审查门禁，以 `skills.zip` 中对应 skill 的真实行为为准。
|
||||
- 同一主题若仍冲突，优先更晚、更具体、更可执行的来源。
|
||||
- 一条正式规则在知识库中只保留一个规范入口。
|
||||
|
||||
## Consequences
|
||||
- 知识库不会成为来源冲突的集合体
|
||||
- 后续更新时可以明确知道该改哪个层级
|
||||
|
||||
## Revisit When
|
||||
- 新一轮会议整理文档替代现有原则层
|
||||
- 新技能包改变了关键执行结构
|
||||
@@ -0,0 +1,65 @@
|
||||
# ADR-2026-03-21 Stack Whitelist And Exception Process
|
||||
|
||||
## Purpose
|
||||
记录 v1 默认技术栈白名单，以及何时允许偏离。
|
||||
|
||||
## When to Use
|
||||
- 新项目选型
|
||||
- 老项目迁移
|
||||
- 团队想引入白名单外技术时
|
||||
|
||||
## Inputs
|
||||
- 项目目标
|
||||
- 性能与兼容要求
|
||||
- 现有遗留约束
|
||||
|
||||
## Outputs
|
||||
- 选型决策
|
||||
- 例外审批结果
|
||||
|
||||
## Primary Agent/Model
|
||||
项目 owner + `GPT-5.4 Pro xhigh`
|
||||
|
||||
## Secondary Agent/Model
|
||||
`Claude Opus 4.6`
|
||||
|
||||
## Required Skills
|
||||
- 无
|
||||
|
||||
## Steps
|
||||
1. 先看是否能落到白名单轨道。
|
||||
2. 如不能，写出偏离理由和范围。
|
||||
3. 审批通过后更新模板与执行说明。
|
||||
|
||||
## Exit Criteria
|
||||
- 项目主链路已落到一个明确轨道
|
||||
|
||||
## Failure Recovery
|
||||
- 若白名单外技术已被引入但没有审批，视为待回退问题
|
||||
|
||||
## Related Templates
|
||||
- [`../templates/claude-md-template.md`](../templates/claude-md-template.md)
|
||||
|
||||
## Status
|
||||
Accepted
|
||||
|
||||
## Context
|
||||
- 团队需要避免 agent 在语言、框架、路由、鉴权和 ORM 上随机选型。
|
||||
- 同时要保留少量例外接口，处理遗留系统和特殊约束。
|
||||
|
||||
## Decision
|
||||
- 默认语言：`TypeScript`
|
||||
- 默认 UI：`React`
|
||||
- 默认优先轨道：`Hono + React SSR/TanStack`
|
||||
- 允许替代轨道：`Next.js 全栈`
|
||||
- 默认基础组件、样式、鉴权、数据访问和 ORM：`shadcn/ui`, `Tailwind`, `Better Auth`, `TanStack Query`, `Drizzle`
|
||||
- 禁止 `Python`、`PHP` 作为应用主链路默认语言
|
||||
- 例外必须由项目 owner 与技术负责人批准，并写 ADR、更新 `CLAUDE.md`、更新相关 playbook 和模板
|
||||
|
||||
## Consequences
|
||||
- agent 在主链路上的自由度下降，但一致性和生成质量上升
|
||||
- 例外变成显式治理动作，而不是隐性扩散
|
||||
|
||||
## Revisit When
|
||||
- 团队默认栈发生正式变更
|
||||
- 某个白名单组件长期无法满足主流项目需求
|
||||
@@ -0,0 +1,46 @@
|
||||
# Decisions Index
|
||||
|
||||
## Purpose
|
||||
集中管理可变化策略的 ADR，避免把模型偏好、来源优先级和例外流程写死在永久规则里。
|
||||
|
||||
## When to Use
|
||||
- 需要改模型默认路线时
|
||||
- 需要处理来源冲突时
|
||||
- 需要批准技术栈例外时
|
||||
|
||||
## Inputs
|
||||
- 当前争议点
|
||||
- 受影响规则
|
||||
- 证据与来源
|
||||
|
||||
## Outputs
|
||||
- 带日期的 ADR
|
||||
|
||||
## Primary Agent/Model
|
||||
项目 owner + `GPT-5.4 Pro xhigh`
|
||||
|
||||
## Secondary Agent/Model
|
||||
`Claude Opus 4.6`
|
||||
|
||||
## Required Skills
|
||||
- 无强制 skill
|
||||
|
||||
## Steps
|
||||
1. 先描述问题和受影响范围。
|
||||
2. 再写决策与后果。
|
||||
3. 更新受影响的知识库页面。
|
||||
|
||||
## Exit Criteria
|
||||
- 争议已收敛
|
||||
- 所有受影响页面已同步
|
||||
|
||||
## Failure Recovery
|
||||
- 如果规则变了但没写 ADR，视为无效变更
|
||||
|
||||
## Related Templates
|
||||
- [`../templates/agent-handoff-template.md`](../templates/agent-handoff-template.md)
|
||||
|
||||
## ADR List
|
||||
- [`ADR-2026-03-21-model-routing-and-fallbacks.md`](./ADR-2026-03-21-model-routing-and-fallbacks.md)
|
||||
- [`ADR-2026-03-21-source-precedence-and-conflict-resolution.md`](./ADR-2026-03-21-source-precedence-and-conflict-resolution.md)
|
||||
- [`ADR-2026-03-21-stack-whitelist-and-exception-process.md`](./ADR-2026-03-21-stack-whitelist-and-exception-process.md)
|
||||
在新工单中引用
屏蔽一个用户