hao/skills
1
0
派生 0
代码 工单 合并请求 工作流 软件包 项目 发布 百科 活动

Enhance cc-switch-dev-workflow bootstrap

浏览代码
这个提交包含在：
X
2026-03-26 07:03:18 -07:00
父节点 dcb2a10ad8
当前提交 9cf61bf80c
共修改 11 个文件，包含 885 行新增和 25 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件

5
cc-switch-dev-workflow/references/knowledge-base/README.md
查看文件

@@ -43,7 +43,7 @@
1. 从 [`sources/README.md`](./sources/README.md) 确认规则来源和冲突取舍。
2. 从 [`playbooks/`](./playbooks/) 选择最贴近当前项目的执行路径。
3. 按 [`workflows/README.md`](./workflows/README.md) 所列阶段运行，每阶段只保留高密度产物进入下一阶段。
4. 统一使用 [`templates/README.md`](./templates/README.md) 中的模板生成 `CLAUDE.md`、`ANALYSIS.md`、`TODO.yaml`、Spec 和 handoff 文档。
4. 统一使用 [`templates/README.md`](./templates/README.md) 中的模板生成 `CLAUDE.md`、`AGENTS.md`、`ANALYSIS.md`、`TODO.yaml`、Spec 和 handoff 文档。
5. 发生技术栈偏离、模型切换、来源冲突时，先写入 [`decisions/README.md`](./decisions/README.md) 中的 ADR，再继续执行。
## Exit Criteria
@@ -58,6 +58,7 @@
## Related Templates
- [`templates/claude-md-template.md`](./templates/claude-md-template.md)
- [`templates/agents-md-template.md`](./templates/agents-md-template.md)
- [`templates/analysis-template.md`](./templates/analysis-template.md)
- [`templates/todo-yaml-template.md`](./templates/todo-yaml-template.md)
- [`templates/agent-handoff-template.md`](./templates/agent-handoff-template.md)
@@ -80,7 +81,7 @@
| 阶段 | 目标 | 核心产物 | 默认主模型 | 默认辅模型 |
|---|---|---|---|---|
| 0 Setup | 项目初始化与规则对齐 | `.meetings/`, `.ralphy/config.yaml`, `CLAUDE.md` | `GPT-5.4 Pro xhigh` | `Claude Opus 4.6` |
| 0 Setup | 项目初始化与规则对齐 | `.meetings/`, `.ralphy/config.yaml`, `CLAUDE.md`, `AGENTS.md` | `GPT-5.4 Pro xhigh` | `Claude Opus 4.6` |
| 1 Research | 形成调研结论 | `ANALYSIS.md`, `TODO.yaml`, `.research/*.md` | `GPT-5.4 Pro xhigh` | `Claude Opus 4.6` |
| 2 Spec | 形成可实施规范 | `SPECS/*.md` | `GPT-5.4 Pro xhigh` | `Claude Opus 4.6` |
| 3 Code | 按 Spec 实施代码 | `.plans/*.md`, 代码与测试 | `GPT-5.4 Pro xhigh` | `Claude Opus 4.6` |

4
cc-switch-dev-workflow/references/knowledge-base/playbooks/existing-project-spec-backfill-and-refactor.md
查看文件

@@ -16,6 +16,7 @@
## Outputs
- 补齐后的 `CLAUDE.md`
- 补齐后的 `AGENTS.md`
- `.research/*.md`
- `SPECS/*.md`
- 重构和补齐计划
@@ -74,7 +75,7 @@
```
## Stage Deliverables
- Setup：补写 `CLAUDE.md`、确认轨道与边界
- Setup：补写 `CLAUDE.md` 与 `AGENTS.md`、确认轨道与边界
- Research：反向整理 `.research/*.md`
- Spec：形成 `SPECS/*.md` 并完成人工审核
- Alignment：对齐现有实现与 Spec
@@ -82,6 +83,7 @@
## Acceptance Checklist
- 老项目已有清晰的 `CLAUDE.md`
- 老项目已有清晰的 `AGENTS.md`
- `SPECS/*.md` 不是代码镜像，而是系统契约
- Alignment 后没有高优先级缺口残留
- Refinement 后的结构与命名更清晰，不是更复杂

4
cc-switch-dev-workflow/references/knowledge-base/playbooks/new-project-from-scaffold.md
查看文件

@@ -16,6 +16,7 @@
## Outputs
- `CLAUDE.md`
- `AGENTS.md`
- `.ralphy/config.yaml`
- `.research/*.md`
- `SPECS/*.md`
@@ -77,7 +78,7 @@
```
## Stage Deliverables
- Setup：`.meetings/`, `.ralphy/config.yaml`, `CLAUDE.md`
- Setup：`.meetings/`, `.ralphy/config.yaml`, `CLAUDE.md`, `AGENTS.md`
- Research：`ANALYSIS.md`, `TODO.yaml`, `.research/*.md`
- Spec：`SPECS/*.md`, 审查结论, 人工审核结论
- Code：`.plans/*.md`, 代码与测试
@@ -86,5 +87,6 @@
## Acceptance Checklist
- 技术轨道只有一个主路线
- `CLAUDE.md` 已固定规则与禁用项
- `AGENTS.md` 已为 Codex 固定读文件顺序、边界和升级点
- `SPECS/*.md` 已通过人工审核
- 第一轮代码实施与 Alignment 已经形成闭环

2
cc-switch-dev-workflow/references/knowledge-base/templates/README.md
查看文件

@@ -4,6 +4,7 @@
提供知识库中的标准模板集合，统一输入输出格式，降低 agent 自由发挥空间。
## When to Use
- 新建 `AGENTS.md`
- 新建 `CLAUDE.md`
- 新建 `ANALYSIS.md`
- 新建 `TODO.yaml`
@@ -44,6 +45,7 @@
| 模板 | 用途 |
|---|---|
| [`agents-md-template.md`](./agents-md-template.md) | Codex 项目执行说明 |
| [`claude-md-template.md`](./claude-md-template.md) | 项目执行说明 |
| [`analysis-template.md`](./analysis-template.md) | 阶段分析报告 |
| [`todo-yaml-template.md`](./todo-yaml-template.md) | 任务清单 |

97
cc-switch-dev-workflow/references/knowledge-base/templates/agents-md-template.md 普通文件
查看文件

@@ -0,0 +1,97 @@
# Template: AGENTS.md
## Purpose
为 Codex 提供项目级执行约束，让实现、审查和交接都遵守同一套边界。
## When to Use
- Setup 阶段
- 项目需要同时支持 `Claude Code` 和 `Codex` 时
- 需要给 Codex 一个稳定的项目执行入口时
## Inputs
- 清洗后的会议纪要
- 技术轨道决策
- 项目目标与边界
- 已确认的 workflow / playbook
## Outputs
- `AGENTS.md`
## Primary Agent/Model
`GPT-5.4 Pro xhigh`
## Secondary Agent/Model
`Claude Opus 4.6`
## Required Skills
- `agent-md-writing`
- 若未安装，按 `claude-md-template.md` 的约束等价改写
## Steps
1. 用下方模板生成草案。
2. 把 `CLAUDE.md` 中的稳定规则压缩为 Codex 可直接执行的指令。
3. 明确 Read First 文件、禁止项、审批点和 handoff 方式。
## Exit Criteria
- Codex 在只读 `AGENTS.md` 的情况下，也能知道项目目标、技术边界、流程门禁和升级点
## Failure Recovery
- 若 `AGENTS.md` 只是重复愿景、不写边界与门禁，回到模板重写
## Related Templates
- [`claude-md-template.md`](./claude-md-template.md)
- [`agent-handoff-template.md`](./agent-handoff-template.md)
## Template
```markdown
# AGENTS.md
## Mission
- Project:
- Goal:
- Audience:
- In Scope:
- Out of Scope:
## Read First
- `CLAUDE.md`
- `ANALYSIS.md`
- `TODO.yaml`
- Selected playbook:
- Key specs:
## Workflow Contract
- Follow stages:
- Current playbook:
- Reset points:
- Human approval gates:
## Stack Guardrails
- Track:
- Language:
- UI:
- Styling:
- Auth:
- Data Fetching:
- Router:
- Service Layer:
- ORM:
- Database:
## Model Routing
- Primary planning and implementation:
- Secondary review:
- Fallback:
## Boundaries
- Do not introduce:
- Do not modify:
- Do not bypass:
- Ask before:
## Execution Defaults
- Preferred testing posture:
- Refactor rhythm:
- Handoff format:
- Done means:
```

6
cc-switch-dev-workflow/references/knowledge-base/workflows/stage-0-setup.md
查看文件

@@ -18,6 +18,7 @@
- 清洗后的 `.meetings/`
- `.ralphy/config.yaml`
- `CLAUDE.md`
- `AGENTS.md`
- 已确认的技术轨道
## Primary Agent/Model
@@ -34,11 +35,11 @@
1. 清洗会议纪要，只保留项目相关决策。
2. 选择 `Next.js 全栈` 或 `Hono + React SSR/TanStack` 轨道。
3. 初始化 `.ralphy/config.yaml`。
4. 生成 `CLAUDE.md`，写明哲学、白名单、边界、测试与技能要求。
4. 生成 `CLAUDE.md` 和 `AGENTS.md`，写明哲学、白名单、边界、测试与技能要求。
5. 产出 Setup handoff，供 Research 或 Spec 阶段读取。
## Exit Criteria
- `CLAUDE.md` 存在且可直接约束 agent
- `CLAUDE.md` 和 `AGENTS.md` 存在且可直接约束 agent
- 技术轨道已固定
- 原始会议纪要不再被直接拿去执行
@@ -48,6 +49,7 @@
## Related Templates
- [`../templates/claude-md-template.md`](../templates/claude-md-template.md)
- [`../templates/agents-md-template.md`](../templates/agents-md-template.md)
- [`../templates/agent-handoff-template.md`](../templates/agent-handoff-template.md)
## Stable Knowledge Vs Runtime Context