Add cc-switch-dev-workflow skill
这个提交包含在:
@@ -0,0 +1,82 @@
|
||||
# Platform Policy: Stack Whitelist
|
||||
|
||||
## Purpose
|
||||
定义 v1 默认技术栈白名单、禁用项和例外审批接口,避免让 agent 在项目主链路上随机选型。
|
||||
|
||||
## When to Use
|
||||
- 新项目立项时
|
||||
- 老项目需要补一套统一技术栈约束时
|
||||
- agent 要新增框架、语言或关键基础设施时
|
||||
|
||||
## Inputs
|
||||
- 项目类型
|
||||
- 产品形态
|
||||
- 现有遗留约束
|
||||
- 性能与交付要求
|
||||
|
||||
## Outputs
|
||||
- 允许的主链路技术栈
|
||||
- 禁用项
|
||||
- 例外审批流程
|
||||
|
||||
## Primary Agent/Model
|
||||
`GPT-5.4 Pro xhigh`
|
||||
|
||||
## Secondary Agent/Model
|
||||
`Claude Opus 4.6`
|
||||
|
||||
## Required Skills
|
||||
- `ralphy-initializing`
|
||||
- `spec-reviewing`
|
||||
|
||||
## Steps
|
||||
1. 先判断项目是 `Next.js 全栈` 还是 `Hono + React SSR/TanStack`。
|
||||
2. 在允许的轨道内固定 UI、数据层、鉴权、样式和 ORM 方案。
|
||||
3. 把选型写进 `CLAUDE.md`、Spec 和脚手架说明。
|
||||
4. 如需偏离白名单,先走 ADR 和审批,再更新模板与执行说明。
|
||||
|
||||
## Exit Criteria
|
||||
- 项目主链路的语言、框架、数据访问、鉴权和样式方案均已固定
|
||||
- 例外项已被 ADR 化,并同步到模板和执行说明
|
||||
|
||||
## Failure Recovery
|
||||
- 如果 agent 引入未批准语言或框架,停止实现并回退到白名单决策
|
||||
- 如果项目同时混用多套主路由/状态/ORM 方案,立即收敛为单一路线
|
||||
|
||||
## Related Templates
|
||||
- [`../templates/claude-md-template.md`](../templates/claude-md-template.md)
|
||||
- [`../templates/spec-template.md`](../templates/spec-template.md)
|
||||
|
||||
## Default Whitelist
|
||||
- 语言:`TypeScript`
|
||||
- UI:`React`
|
||||
- 样式:`Tailwind CSS`
|
||||
- 组件:`shadcn/ui`
|
||||
- 鉴权:`Better Auth`
|
||||
- 数据获取:`TanStack Query`
|
||||
- 路由:`TanStack Router` 或 `Next.js App Router`,按轨道二选一
|
||||
- 服务层:`Hono` 或 `Next.js route handlers / server actions`,按轨道二选一
|
||||
- ORM:`Drizzle`
|
||||
- 数据库:`PostgreSQL`
|
||||
|
||||
## Default Track Preference
|
||||
- 默认优先:`Hono + React SSR/TanStack`
|
||||
- 条件允许时可选:`Next.js 全栈`
|
||||
|
||||
## Hard Bans On The Application Main Path
|
||||
- 禁止 `Python` 作为产品应用主链路语言
|
||||
- 禁止 `PHP` 作为产品应用主链路语言
|
||||
- 禁止无类型的 `JavaScript-only` 作为默认实现路线
|
||||
- 禁止未经 ADR 批准的第二套路由、鉴权、ORM 或样式体系并存
|
||||
|
||||
## Allowed Exceptions
|
||||
- 既有遗留系统必须兼容,且短期无法迁移
|
||||
- 明确的第三方平台限制只支持某一特定方案
|
||||
- 已被性能分析证明主链路栈无法满足约束
|
||||
- 一次性离线工具、迁移脚本或数据清洗脚本
|
||||
|
||||
## Exception Interface
|
||||
- 谁批准:项目 owner + 技术负责人
|
||||
- 需要补什么:ADR、`CLAUDE.md` 更新、相关 Spec 更新
|
||||
- 要同步哪里:playbook 说明、模板默认值、handoff 约束
|
||||
- 何时失效:例外只对当前项目或当前子系统生效,不自动扩散为默认规则
|
||||
在新工单中引用
屏蔽一个用户