Add cc-switch-dev-workflow skill

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

查看文件

@@ -0,0 +1,71 @@
# Platform Policy: Framework Decision Matrix
## Purpose
`Next.js 全栈``Hono + React SSR/TanStack` 两条允许轨道之间做可重复的选择,而不是让 agent 自行随机决定。
## When to Use
- 新项目初始化时
- 老项目需要明确迁移目标时
- 团队对 “Next.js 还是 Hono” 出现争议时
## Inputs
- 产品是否以前端页面为主
- API 边界是否需要长期清晰分层
- SSR/边缘部署要求
- 团队是否需要复用独立服务层
## Outputs
- 选定轨道
- 该轨道下保留或替代的技术组合
## Primary Agent/Model
`GPT-5.4 Pro xhigh`
## Secondary Agent/Model
`Claude Opus 4.6`
## Required Skills
- `spec-reviewing`
## Steps
1. 先看项目交付形态和团队协作方式。
2. 按矩阵选一条轨道,不接受双主栈并行。
3. 把选择结果写入 `CLAUDE.md` 和 Setup 阶段产物。
## Exit Criteria
- 轨道已经确定
- 相关被替代组件已经说明清楚
## Failure Recovery
- 如果出现两条轨道同时存在的设计,先回到单轨道
- 如果团队只是因为“看起来都不错”而摇摆,优先选择更有边界感的 `Hono + React SSR/TanStack`
## Related Templates
- [`../templates/claude-md-template.md`](../templates/claude-md-template.md)
## Decision Matrix
| 条件 | 选 `Hono + React SSR/TanStack` | 选 `Next.js 全栈` |
|---|---|---|
| 需要清晰前后端边界 | 是 | 否 |
| 需要独立服务层或未来拆服务 | 是 | 否 |
| 团队希望统一 `TanStack Router + Query` 心智 | 是 | 否 |
| 更看重单仓单应用的快速落地 | 否 | 是 |
| 页面和服务逻辑高度耦合 | 否 | 是 |
| 需要高度可控的 API 中间层 | 是 | 否 |
## Track A: Hono + React SSR/TanStack
- 默认场景:内部工具、业务系统、需要清晰服务边界的产品
- 固定组合:`Hono` + `React` + `TanStack Router` + `TanStack Query` + `Better Auth` + `shadcn/ui` + `Tailwind` + `Drizzle`
- 优点:边界清晰,迁移和拆分成本低,适合多 agent 任务切片
- 代价:初始装配稍多,需要更强的工程纪律
## Track B: Next.js Full Stack
- 默认场景:页面驱动、内容驱动、单体交付优先的应用
- 固定组合:`Next.js` + `React` + `Better Auth` + `shadcn/ui` + `Tailwind` + `Drizzle`
- 替代说明:本轨道中 `Next.js App Router` 替代 `TanStack Router`;服务层由 `route handlers / server actions` 替代 `Hono`
- 优点:统一框架、上手快、页面与服务同仓同形态
- 代价:边界容易模糊,后续抽服务时需要更多治理
## Tie-Break Rule
- 如果没有明确理由支持 `Next.js 全栈`,默认回到 `Hono + React SSR/TanStack`