@colin4k1024/tsp 2.4.0

package/examples/INDEX.md

@@ -0,0 +1,232 @@
+# Examples Index
+
+这份索引用来回答一个问题：项目级 `CLAUDE.md` 到底该从哪个示例开始。
+
+职责划分：
+
+- `project-CLAUDE.md`：完整主模板，可直接复制改造
+- `saas-nextjs-CLAUDE.md`：相对主模板的前端差异指南 + 精简成品
+- `springboot-service-CLAUDE.md`：相对主模板的后端差异指南 + 精简成品
+- `workflow-enterprise-CLAUDE.md`：流程审批 / 权限联动型企业项目模板
+- `platform-governance-CLAUDE.md`：平台治理 / 命令技能仓库模板
+- `data-analytics-dashboard-CLAUDE.md`：数据看板 / 分析台项目模板
+- `github-actions-supply-chain-CLAUDE.md`：GitHub Actions / 供应链治理仓库模板
+- `ai-eval-platform-CLAUDE.md`：AI / Eval 平台项目模板
+- `mobile-miniapp-CLAUDE.md`：移动端 / 小程序项目模板
+- `iac-kubernetes-platform-CLAUDE.md`：IaC / Kubernetes 平台仓库模板
+- `plugin-extension-platform-CLAUDE.md`：插件 / 扩展仓库模板
+- `data-ml-pipeline-CLAUDE.md`：数据 / ML pipeline 仓库模板
+- `security-compliance-platform-CLAUDE.md`：安全 / 合规平台仓库模板
+- `internal-developer-platform-CLAUDE.md`：内部开发者平台模板
+- `data-observability-quality-CLAUDE.md`：数据可观测性 / 质量平台模板
+- `user-CLAUDE.md`：用户级偏好，不是项目级模板
+- `claude-conversation-script.md`：Claude 端可直接复制的会话脚本
+- `claude-scenario-playbook.md`：Claude 端按任务类型选示例的场景集
+- `codex-conversation-script.md`：Codex 端可直接复制的会话脚本
+- `codex-scenario-playbook.md`：Codex 端按任务类型选示例的场景集
+- `enterprise-overlay-scenario-playbook.md`：自定义 overlay 扩展场景的兼容占位入口
+- `enterprise-overlay-output-playbook.md`：自定义 overlay 扩展输出示例的兼容占位入口
+- `role-conversation-scripts.md`：角色级高频会话脚本合集
+- `project-type-starter-playbook.md`：按项目类型直接复制 Claude / Codex 起手句
+- `vertical-project-conversation-scripts.md`：更垂直项目类型的连续对话脚本
+- `full-lifecycle-demo.md`：完整交付生命周期演示脚本（通用审批与交付系统，覆盖 intake→plan→execute→handoff→review→release→closeout 全链路，已对齐新版主链）
+- `full-lifecycle-demo-30min.md`：30 分钟深度演示版（带时间切片、主持人讲解重点、切屏顺序与问答预案）
+
+如果你想先按命令或能力找示例，而不是按项目类型找，先看 [../docs/runbooks/command-and-capability-matrix.md](../docs/runbooks/command-and-capability-matrix.md)。
+
+如果你想理解主模板每一段为什么这样设计，看 [../docs/runbooks/project-claude-design-rationale.md](../docs/runbooks/project-claude-design-rationale.md)。
+
+## 快速选择
+
+| 想体验完整链路：从需求文档到最终上线收口的全流程 | [full-lifecycle-demo.md](full-lifecycle-demo.md) | 含阶段脚本、主持人串词、重点展示 artifact，覆盖 `release` 后的 `closeout` 收口 |
+| 你要正式做一场 30 分钟平台宣讲 | [full-lifecycle-demo-30min.md](full-lifecycle-demo-30min.md) | 含时间安排、讲解节奏、重点文件、问答预案，适合正式演示 |
+| 你的项目类型 | 推荐起点 | 原因 |
+|--------------|----------|------|
+| 前后端混合、中后台平台、角色较完整 | [project-CLAUDE.md](project-CLAUDE.md) | 结构最完整，适合作为默认主模板 |
+| Next.js / React / Tailwind，前端是主战场 | [saas-nextjs-CLAUDE.md](saas-nextjs-CLAUDE.md) | 这是前端差异指南，告诉你如何从主模板收缩到前端版 |
+| Spring Boot / JPA / MySQL，后端是主战场 | [springboot-service-CLAUDE.md](springboot-service-CLAUDE.md) | 这是后端差异指南，告诉你如何从主模板收缩到后端版 |
+| 审批流 / 工作流 / 权限联动明显的企业项目 | [workflow-enterprise-CLAUDE.md](workflow-enterprise-CLAUDE.md) | 适合长期命中 custom overlay 与发布治理的场景 |
+| 命令 / skills / docs / hooks 为主的平台治理仓库 | [platform-governance-CLAUDE.md](platform-governance-CLAUDE.md) | 适合平台基建、治理和能力同步任务 |
+| BI 看板 / 运营分析台 / 报表中心 | [data-analytics-dashboard-CLAUDE.md](data-analytics-dashboard-CLAUDE.md) | 适合指标口径、图表、查询性能和导出边界都很重要的项目 |
+| GitHub Actions / 供应链治理仓库 | [github-actions-supply-chain-CLAUDE.md](github-actions-supply-chain-CLAUDE.md) | 适合 workflow、permissions、attestation、SBOM、签名治理 |
+| AI / Eval 平台 | [ai-eval-platform-CLAUDE.md](ai-eval-platform-CLAUDE.md) | 适合 grader、pass@k、评测闭环和成本边界都很重要的项目 |
+| 移动端 / 小程序项目 | [mobile-miniapp-CLAUDE.md](mobile-miniapp-CLAUDE.md) | 适合多终端适配、弱网、权限路径和交互反馈都很重要的项目 |
+| IaC / Kubernetes 平台仓库 | [iac-kubernetes-platform-CLAUDE.md](iac-kubernetes-platform-CLAUDE.md) | 适合 chart、schema、policy、dry-run 与发布基线治理 |
+| 插件 / 扩展仓库 | [plugin-extension-platform-CLAUDE.md](plugin-extension-platform-CLAUDE.md) | 适合宿主集成点、命令面、配置面、安装路径和兼容矩阵治理 |
+| 数据 / ML pipeline 仓库 | [data-ml-pipeline-CLAUDE.md](data-ml-pipeline-CLAUDE.md) | 适合数据口径、任务编排、回填风险和质量校验都很重要的项目 |
+| 安全 / 合规平台仓库 | [security-compliance-platform-CLAUDE.md](security-compliance-platform-CLAUDE.md) | 适合门禁分层、权限边界、审计证据、例外管理和放行规则治理 |
+| 内部开发者平台 | [internal-developer-platform-CLAUDE.md](internal-developer-platform-CLAUDE.md) | 适合开发者入口、自助模板、平台 API、失败兜底和发布前提治理 |
+| 数据可观测性 / 质量平台 | [data-observability-quality-CLAUDE.md](data-observability-quality-CLAUDE.md) | 适合规则口径、异常阈值、告警路径、误报漏报和修复闭环治理 |
+| 只想配置个人默认偏好，不是配置项目 | [user-CLAUDE.md](user-CLAUDE.md) | 这是用户级配置，不是项目级模板 |
+| 想直接复制 Claude 对话脚本 | [claude-conversation-script.md](claude-conversation-script.md) | 适合先跑主链和短链路示例 |
+| 想按 Claude 任务类型直接选脚本 | [claude-scenario-playbook.md](claude-scenario-playbook.md) | 适合按“新功能 / 小修复 / 发布 / specialist 收口”快速起手 |
+| 想直接复制 Codex 对话脚本 | [codex-conversation-script.md](codex-conversation-script.md) | 适合先跑并行编排和收口示例 |
+| 想按 Codex 并行场景直接选脚本 | [codex-scenario-playbook.md](codex-scenario-playbook.md) | 适合按“前端并行 / 后端并行 / build-fix / 发布”快速起手 |
+| 想快速判断是否需要自定义 overlay 扩展 | [../docs/runbooks/custom-overlay.md](../docs/runbooks/custom-overlay.md) | 适合先确认任务是否依赖 custom overlay |
+| 想看自定义 overlay 扩展兼容入口 | [../docs/runbooks/custom-overlay.md](../docs/runbooks/custom-overlay.md) | 适合保留企业扩展入口，但不在公开仓承载内部内容 |
+| 想按角色复制高频说法 | [role-conversation-scripts.md](role-conversation-scripts.md) | 适合 QA、DevOps、Tech Lead、PM、Architect |
+| 想按项目类型直接复制第一段话 | [project-type-starter-playbook.md](project-type-starter-playbook.md) | 适合流程型企业项目、平台治理仓库、数据看板项目 |
+| 想先体验 TDD、Harness Audit 或 runtime 能力 | [claude-scenario-playbook.md](claude-scenario-playbook.md) / [codex-scenario-playbook.md](codex-scenario-playbook.md) | 适合按能力而不是按项目类型起手 |
+
+## 选择信号
+
+- 如果你不确定应该删掉哪些角色、哪些命令、哪些约束，先从 [project-CLAUDE.md](project-CLAUDE.md) 开始
+- 如果你知道项目明显是前端主导，再看 [saas-nextjs-CLAUDE.md](saas-nextjs-CLAUDE.md)
+- 如果你知道项目明显是后端主导，再看 [springboot-service-CLAUDE.md](springboot-service-CLAUDE.md)
+- 如果你还不理解每个章节存在的目的，先看 [../docs/runbooks/project-claude-design-rationale.md](../docs/runbooks/project-claude-design-rationale.md)
+
+## 推荐学习路径
+
+### 路径 A：第一次接入全栈项目
+
+1. 先看完整链路演示 [full-lifecycle-demo.md](full-lifecycle-demo.md)，在真实业务场景中感受每个阶段的输入、输出和演示顺序
+2. 如果你要对内正式讲解，再补看 [full-lifecycle-demo-30min.md](full-lifecycle-demo-30min.md)
+3. 再看 [../docs/runbooks/project-claude-design-rationale.md](../docs/runbooks/project-claude-design-rationale.md)
+4. 再复制和改造 [project-CLAUDE.md](project-CLAUDE.md)
+5. 然后回到 [../docs/runbooks/project-onboarding.md](../docs/runbooks/project-onboarding.md)
+
+### 路径 B：前端主导项目
+
+1. 先看 [saas-nextjs-CLAUDE.md](saas-nextjs-CLAUDE.md)
+2. 如果发现后端或发布约束开始变重，再回退到 [project-CLAUDE.md](project-CLAUDE.md)
+
+### 路径 C：后端主导项目
+
+1. 先看 [springboot-service-CLAUDE.md](springboot-service-CLAUDE.md)
+2. 如果后续前端交付变重，再补充通用版中的前端门禁和角色链路
+
+### 路径 D：自定义 overlay 扩展场景
+
+1. 先看 [../docs/runbooks/custom-overlay.md](../docs/runbooks/custom-overlay.md)
+2. 再看 [../docs/runbooks/custom-overlay.md](../docs/runbooks/custom-overlay.md)
+3. 最后再回到 [project-CLAUDE.md](project-CLAUDE.md) 或你的项目模板，把长期有效的 overlay 约束并回项目级配置
+
+### 路径 E：流程型企业项目
+
+1. 先看 [workflow-enterprise-CLAUDE.md](workflow-enterprise-CLAUDE.md)
+2. 再补看 [../docs/runbooks/custom-overlay.md](../docs/runbooks/custom-overlay.md)
+3. 如果发布与观察要求较重，再看 [../docs/runbooks/custom-overlay.md](../docs/runbooks/custom-overlay.md)
+
+### 路径 F：平台治理仓库
+
+1. 先看 [platform-governance-CLAUDE.md](platform-governance-CLAUDE.md)
+2. 再看 [../docs/runbooks/command-and-capability-matrix.md](../docs/runbooks/command-and-capability-matrix.md)
+3. 最后按 [../docs/runbooks/platform-capability-demo-script.md](../docs/runbooks/platform-capability-demo-script.md) 跑一次演示链路
+
+### 路径 G：数据看板项目
+
+1. 先看 [data-analytics-dashboard-CLAUDE.md](data-analytics-dashboard-CLAUDE.md)
+2. 如果前端权重更高但查询复杂度一般，再回到 [saas-nextjs-CLAUDE.md](saas-nextjs-CLAUDE.md)
+3. 如果后端查询或聚合逻辑明显更重，再补 [springboot-service-CLAUDE.md](springboot-service-CLAUDE.md)
+
+### 路径 H：GitHub Actions / 供应链治理仓库
+
+1. 先看 [github-actions-supply-chain-CLAUDE.md](github-actions-supply-chain-CLAUDE.md)
+2. 再看 [vertical-project-conversation-scripts.md](vertical-project-conversation-scripts.md)
+3. 最后按 [../docs/runbooks/actionlint-workflow-gates.md](../docs/runbooks/actionlint-workflow-gates.md) 和 [../docs/runbooks/scorecard-supply-chain-gates.md](../docs/runbooks/scorecard-supply-chain-gates.md) 继续细化
+
+### 路径 I：AI / Eval 平台
+
+1. 先看 [ai-eval-platform-CLAUDE.md](ai-eval-platform-CLAUDE.md)
+2. 再看 [vertical-project-conversation-scripts.md](vertical-project-conversation-scripts.md)
+3. 如果要解释命令和 runtime 的配合，再看 [../docs/runbooks/ecc-harness-usage.md](../docs/runbooks/ecc-harness-usage.md)
+
+### 路径 J：移动端 / 小程序项目
+
+1. 先看 [mobile-miniapp-CLAUDE.md](mobile-miniapp-CLAUDE.md)
+2. 再看 [vertical-project-conversation-scripts.md](vertical-project-conversation-scripts.md)
+3. 如果只是普通 Web 响应式页面，再回到 [saas-nextjs-CLAUDE.md](saas-nextjs-CLAUDE.md)
+
+### 路径 K：IaC / Kubernetes 平台仓库
+
+1. 先看 [iac-kubernetes-platform-CLAUDE.md](iac-kubernetes-platform-CLAUDE.md)
+2. 再看 [project-type-starter-playbook.md](project-type-starter-playbook.md)
+3. 如果要按现有 demo 成熟度决定讲解顺序，再看 [../docs/presentation/vertical-scenario-route-map.md](../docs/presentation/vertical-scenario-route-map.md)
+
+### 路径 L：插件 / 扩展仓库
+
+1. 先看 [plugin-extension-platform-CLAUDE.md](plugin-extension-platform-CLAUDE.md)
+2. 再看 [project-type-starter-playbook.md](project-type-starter-playbook.md)
+3. 如果当前仓库本身还是平台治理仓库，再补 [platform-governance-CLAUDE.md](platform-governance-CLAUDE.md)
+
+### 路径 M：数据 / ML pipeline 仓库
+
+1. 先看 [data-ml-pipeline-CLAUDE.md](data-ml-pipeline-CLAUDE.md)
+2. 再看 [project-type-starter-playbook.md](project-type-starter-playbook.md)
+3. 如果项目更偏结果评测和 agent 基线，再补 [ai-eval-platform-CLAUDE.md](ai-eval-platform-CLAUDE.md)
+
+### 路径 N：安全 / 合规平台仓库
+
+1. 先看 [security-compliance-platform-CLAUDE.md](security-compliance-platform-CLAUDE.md)
+2. 再看 [project-type-starter-playbook.md](project-type-starter-playbook.md)
+3. 如果要按治理演示顺序或 demo 完整度决定入口，再看 [../docs/presentation/vertical-scenario-route-map.md](../docs/presentation/vertical-scenario-route-map.md) 和 [../docs/runbooks/vertical-scenario-capability-matrix.md](../docs/runbooks/vertical-scenario-capability-matrix.md)
+
+### 路径 O：内部开发者平台
+
+1. 先看 [internal-developer-platform-CLAUDE.md](internal-developer-platform-CLAUDE.md)
+2. 再看 [project-type-starter-playbook.md](project-type-starter-playbook.md)
+3. 如果当前仓库还承担平台治理职责，再补 [platform-governance-CLAUDE.md](platform-governance-CLAUDE.md)
+
+### 路径 P：数据可观测性 / 质量平台
+
+1. 先看 [data-observability-quality-CLAUDE.md](data-observability-quality-CLAUDE.md)
+2. 再看 [project-type-starter-playbook.md](project-type-starter-playbook.md)
+3. 如果项目更偏数据任务编排和回填，再补 [data-ml-pipeline-CLAUDE.md](data-ml-pipeline-CLAUDE.md)
+
+## 三类示例的核心差异
+
+| 维度 | 通用版 | 前端版 | 后端版 |
+|------|--------|--------|--------|
+| 默认角色 | 更完整 | 更偏前端 | 更偏后端 |
+| 默认命令流 | 主链完整 | 更强调 `/multi-frontend` | 更强调 `/multi-backend` |
+| 默认技能装配 | shared + 前后端 + 通用专项 | shared + 前端专项 | shared + 后端专项 |
+| custom overlay | 默认关闭，按任务判断 | 默认关闭，通常较少启用 | 默认关闭，但更可能命中流程或权限场景 |
+
+补充理解：
+
+- `workflow-enterprise-CLAUDE.md` 更强调 custom overlay 判断、发布观察和完整主链
+- `platform-governance-CLAUDE.md` 更强调 `/tdd`、`/harness-audit` 和文档一致性
+- `data-analytics-dashboard-CLAUDE.md` 更强调指标口径、图表交互、查询性能和导出边界
+- `github-actions-supply-chain-CLAUDE.md` 更强调 workflow 门禁、token 权限、provenance 与发布证据链
+- `ai-eval-platform-CLAUDE.md` 更强调 grader、pass@k、eval 回归和成本边界
+- `mobile-miniapp-CLAUDE.md` 更强调终端差异、弱网、授权路径和交互反馈
+- `iac-kubernetes-platform-CLAUDE.md` 更强调 chart、schema、policy、dry-run 和发布基线的分层验证
+- `plugin-extension-platform-CLAUDE.md` 更强调宿主集成点、命令面、配置面、安装路径和兼容矩阵
+- `data-ml-pipeline-CLAUDE.md` 更强调数据口径、任务窗口、质量校验、回填风险和结果追溯
+- `security-compliance-platform-CLAUDE.md` 更强调风险分层、权限边界、例外管理、审计证据和放行结论
+- `internal-developer-platform-CLAUDE.md` 更强调开发者入口、模板行为、失败兜底、人工介入和发布前提
+- `data-observability-quality-CLAUDE.md` 更强调规则口径、异常阈值、告警有效性、误报漏报和修复责任
+
+## 使用注意
+
+- `user-CLAUDE.md` 只放个人偏好，不放项目事实
+- `project-claude-design-rationale.md` 用于学习，不建议把设计说明直接放进项目根目录
+- `saas-nextjs-CLAUDE.md` 和 `springboot-service-CLAUDE.md` 不是完全独立世界，它们是在通用版基础上做场景化收缩
+- 所有项目级模板都建议保留主链收口角色，不要只剩 specialist
+
+## 会话脚本入口
+
+- Claude 直接开跑：看 [claude-conversation-script.md](claude-conversation-script.md)
+- Claude 按场景选：看 [claude-scenario-playbook.md](claude-scenario-playbook.md)
+- Codex 直接开跑：看 [codex-conversation-script.md](codex-conversation-script.md)
+- Codex 按场景选：看 [codex-scenario-playbook.md](codex-scenario-playbook.md)
+- 自定义 overlay 扩展兼容入口：看 [enterprise-overlay-scenario-playbook.md](enterprise-overlay-scenario-playbook.md)
+- 自定义 overlay 扩展输出兼容入口：看 [enterprise-overlay-output-playbook.md](enterprise-overlay-output-playbook.md)
+- 按角色补局部收口：看 [role-conversation-scripts.md](role-conversation-scripts.md)
+- 按项目类型直接复制起手句：看 [project-type-starter-playbook.md](project-type-starter-playbook.md)
+- 按更垂直项目类型复制连续脚本：看 [vertical-project-conversation-scripts.md](vertical-project-conversation-scripts.md)
+- 按材料成熟度或讲解目标选 vertical 场景：看 [../docs/presentation/vertical-scenario-route-map.md](../docs/presentation/vertical-scenario-route-map.md)
+- 按表格查看 vertical 场景材料覆盖：看 [../docs/runbooks/vertical-scenario-capability-matrix.md](../docs/runbooks/vertical-scenario-capability-matrix.md)
+
+## 按能力找示例
+
+- 想从 `/tdd` 起手：先看 [claude-scenario-playbook.md](claude-scenario-playbook.md) 和 [codex-scenario-playbook.md](codex-scenario-playbook.md)
+- 想用 `/harness-audit` 做平台自检：先看 [claude-scenario-playbook.md](claude-scenario-playbook.md) 和 [codex-scenario-playbook.md](codex-scenario-playbook.md)
+- 想理解 observation、cost、budget、compact 这些后台机制：先看 [../docs/runbooks/runtime-capabilities-overview.md](../docs/runbooks/runtime-capabilities-overview.md)
+- 想做一场专门讲新增能力的演示：看 [../docs/runbooks/platform-capability-demo-script.md](../docs/runbooks/platform-capability-demo-script.md) 和 [../docs/runbooks/platform-capability-demo-execution-log.md](../docs/runbooks/platform-capability-demo-execution-log.md)
+- 想直接复用 vertical 场景的 demo 台账：看 [../docs/runbooks/github-actions-supply-chain-demo-execution-log.md](../docs/runbooks/github-actions-supply-chain-demo-execution-log.md)、[../docs/runbooks/ai-eval-platform-demo-execution-log.md](../docs/runbooks/ai-eval-platform-demo-execution-log.md)、[../docs/runbooks/mobile-miniapp-demo-execution-log.md](../docs/runbooks/mobile-miniapp-demo-execution-log.md)
+- 想直接照着讲 vertical 场景 demo：看 [../docs/runbooks/github-actions-supply-chain-demo-script.md](../docs/runbooks/github-actions-supply-chain-demo-script.md)、[../docs/runbooks/ai-eval-platform-demo-script.md](../docs/runbooks/ai-eval-platform-demo-script.md)、[../docs/runbooks/mobile-miniapp-demo-script.md](../docs/runbooks/mobile-miniapp-demo-script.md)
+- 想直接复用更多 vertical 场景的 demo 台账：看 [../docs/runbooks/iac-kubernetes-platform-demo-execution-log.md](../docs/runbooks/iac-kubernetes-platform-demo-execution-log.md)、[../docs/runbooks/plugin-extension-platform-demo-execution-log.md](../docs/runbooks/plugin-extension-platform-demo-execution-log.md)、[../docs/runbooks/data-ml-pipeline-demo-execution-log.md](../docs/runbooks/data-ml-pipeline-demo-execution-log.md)
+- 想直接照着讲更多 vertical 场景 demo：看 [../docs/runbooks/iac-kubernetes-platform-demo-script.md](../docs/runbooks/iac-kubernetes-platform-demo-script.md)、[../docs/runbooks/plugin-extension-platform-demo-script.md](../docs/runbooks/plugin-extension-platform-demo-script.md)、[../docs/runbooks/data-ml-pipeline-demo-script.md](../docs/runbooks/data-ml-pipeline-demo-script.md)
+- 想直接复用新增 vertical 场景的 demo 台账：看 [../docs/runbooks/security-compliance-platform-demo-execution-log.md](../docs/runbooks/security-compliance-platform-demo-execution-log.md)、[../docs/runbooks/internal-developer-platform-demo-execution-log.md](../docs/runbooks/internal-developer-platform-demo-execution-log.md)、[../docs/runbooks/data-observability-quality-demo-execution-log.md](../docs/runbooks/data-observability-quality-demo-execution-log.md)
+- 想直接照着讲新增 vertical 场景 demo：看 [../docs/runbooks/security-compliance-platform-demo-script.md](../docs/runbooks/security-compliance-platform-demo-script.md)、[../docs/runbooks/internal-developer-platform-demo-script.md](../docs/runbooks/internal-developer-platform-demo-script.md)、[../docs/runbooks/data-observability-quality-demo-script.md](../docs/runbooks/data-observability-quality-demo-script.md)

package/examples/ai-eval-platform-CLAUDE.md

@@ -0,0 +1,82 @@
+# Example AI Eval Platform CLAUDE.md
+
+适用于 AI 应用平台、模型评测平台、提示词工程平台、Agent 编排平台或 Eval 驱动开发仓库。
+
+这类项目的核心不是单个业务 CRUD，而是任务定义、评测闭环、pass@k、数据集、运行成本和结果可解释性。
+
+## 适用信号
+
+- 需求经常涉及 prompt、agent、eval、benchmark、grader、dataset 或 pass@k
+- 成功标准不是单纯“功能能跑”，而是“结果达标且可回归验证”
+- runtime 成本、上下文预算和长会话稳定性会影响项目设计
+
+## 相对通用版的主要差异
+
+### 1. `/tdd` 与 `eval-harness` 会更高频
+
+- `/tdd` 用来先锁评测口径、成功标准和回归边界
+- `eval-harness` 用来承接 EDD、pass@k 和基线回归
+- `/verify` 负责收最终验证证据
+
+### 2. 命令流更强调“先定义评测，再实现”
+
+- 建议链路：`/team-intake` -> `/team-plan` -> `/tdd` -> `/team-execute` -> `/verify` -> `/team-review`
+- 若平台本身是 agent / skill 仓库，可再补 `/harness-audit`
+
+### 3. 项目约束更偏结果质量和成本
+
+- 必须写清 grader 口径、数据集范围、评测样本和成功阈值
+- 必须说明哪些能力依赖 runtime 预算、cost tracking 或 compact
+- prompt、agent 或 eval 调整后必须保留回归结论，而不是只展示单次运行结果
+
+## 一份更适合 AI / Eval 平台的精简成品
+
+````md
+# AI Eval Platform Working Agreement
+
+## 项目定位
+
+- 类型：AI 应用 / 评测平台 / Agent 编排平台
+- 重点：任务定义、评测闭环、pass@k、成本控制、回归验证
+
+## 默认角色
+
+- `tech-lead`
+- `architect`
+- `backend-engineer`
+- `qa-engineer`
+- 若涉及界面与运营台，再引入 `frontend-engineer`
+
+## 默认命令流
+
+1. `/team-intake`
+2. `/team-plan`
+3. `/tdd`
+4. `/team-execute`
+5. `/verify`
+6. `/team-review`
+
+## 项目约束
+
+- 先定义 grader、样本范围、成功阈值，再开始实现
+- Prompt、agent 或 eval 变更后必须保留回归结论
+- 必须说明哪些能力依赖成本预算、上下文压缩或 runtime 机制
+
+## 常用提示模板
+
+```text
+/team-intake
+目标：为问答 Agent 新增评测闭环与回归基线
+范围：eval case、grader、执行脚本、结果汇总、测试计划
+不做：业务 UI 重构
+约束：必须明确 pass@k、grader 口径、样本范围和成本边界
+```
+
+```text
+/tdd
+基于当前需求，先定义 grader、样本范围、成功阈值和回归边界。
+如果适合 eval-driven development，也请说明哪些环节应搭配 eval-harness。
+```
+````
+
+继续阅读：看 [../docs/runbooks/command-and-capability-matrix.md](../docs/runbooks/command-and-capability-matrix.md) 和 [../docs/runbooks/ecc-harness-usage.md](../docs/runbooks/ecc-harness-usage.md)。

package/examples/claude-conversation-script.md

@@ -0,0 +1,107 @@
+# Example Claude Conversation Script
+
+这份脚本适合第一次在 Claude 里跑 Team Skills Platform 主链时直接复制。它不是规范说明，而是一份可以边改边用的会话脚本。
+
+## 场景 A：后端接口需求
+
+第一句：
+
+```text
+请按 Team Skills Platform 工作模型处理当前任务。
+先以 tech-lead 视角执行 /team-intake，输出目标、范围外事项、参与角色、主要风险和下一步建议。
+
+任务背景：
+- 目标：新增订单审批状态查询接口
+- 范围：接口、权限校验、测试计划
+- 不做：前端页面
+- 约束：如果命中私有流程、权限或其他企业扩展场景，按 `enterprise-overlay-scenario-playbook.md` 的写法明确判断
+```
+
+第二句：
+
+```text
+基于当前 intake 结果继续执行 /team-plan。
+请拆出角色职责、依赖、handoff 节点、风险和技能装配清单。
+如果命中 custom overlay 或兼容 runbook，也请明确写出是正式启用、仅保留候选，还是按场景使用。
+```
+
+第三句：
+
+```text
+/team-execute
+按当前 plan 执行 backend-engineer 的实现和自测。
+输出代码变更摘要、自测结果、待确认事项，以及需要进入 handoff 的信息。
+```
+
+第四句：
+
+```text
+/handoff
+请把当前阶段结论整理成结构化交接，供 QA 继续处理。
+```
+
+第五句：
+
+```text
+/team-review
+基于当前 handoff 结果，输出测试结论、阻塞项、放行建议和残余风险。
+```
+
+## 场景 B：前端小缺陷
+
+第一句：
+
+```text
+请按 Team Skills Platform 处理这个前端问题。
+先执行 /team-intake，并明确输出是否命中 frontend-quality-gates、响应式验证和 ui-review-checklist。
+
+任务：修复订阅页在 iPad 横屏下的布局溢出。
+范围：页面布局、响应式回归、UI 自测证据。
+不做：接口改造。
+```
+
+第二句：
+
+```text
+这是一个边界清晰的小修复。
+请先判断是否可以走短链路；如果可以，按 /code-review -> /handoff -> /team-review 的顺序给出建议。
+如果不适合短链路，请说明必须补 /team-plan 的原因。
+```
+
+## 场景 C：测试先行开发
+
+第一句：
+
+```text
+/team-plan
+基于当前需求拆解实现任务，并给出适合进入 /tdd 的最小上下文。
+```
+
+第二句：
+
+```text
+/tdd
+目标：新增订单审批记录查询能力
+现有缺口：还没有测试和回归边界
+成功标准：请先给出 red-green-refactor 路径，并整理为可直接进入 /team-execute 的动作清单。
+```
+
+## 场景 D：平台能力自检
+
+第一句：
+
+```text
+/harness-audit
+目标：检查当前平台的命令、skills、hooks、rules、文档和集成深度。
+输出：Overall Score、Dimension Scores、Top Actions、Recommendations。
+请再补一段：哪些结论需要回到 README、quick start、examples 或 team-skills-usage。
+```
+
+## 使用建议
+
+- 先改目标、范围、不做和约束，再发给模型
+- specialist 出来后，补一句“整理成可进入 /handoff 的格式”
+- 如果你想知道 `/tdd`、`/harness-audit` 分别适合什么任务，先看 [../docs/runbooks/specialist-commands-playbook.md](../docs/runbooks/specialist-commands-playbook.md)
+- 如果任务命中私有流程、权限、发布或观测扩展，不要在这里继续堆细节，直接跳到 [enterprise-overlay-scenario-playbook.md](enterprise-overlay-scenario-playbook.md) 和 [enterprise-overlay-output-playbook.md](enterprise-overlay-output-playbook.md)
+- 如果你更想看自然语言模板，继续看 [../docs/runbooks/claude-conversation-prompt-recipes.md](../docs/runbooks/claude-conversation-prompt-recipes.md)
+- 如果你想看完整成品对话，继续看 [../docs/runbooks/claude-end-to-end-conversation-example.md](../docs/runbooks/claude-end-to-end-conversation-example.md)

package/examples/claude-scenario-playbook.md

@@ -0,0 +1,113 @@
+# Claude Scenario Playbook
+
+这份示例集不解释概念，只回答一个问题：在 Claude 里碰到不同任务时，第一段话到底该怎么发。
+
+## 快速选择
+
+| 任务 | 推荐起手 | 何时用 |
+|------|----------|--------|
+| 新功能完整主链 | `/team-intake` -> `/team-plan` | 需求、角色、风险都还没锁定 |
+| 小缺陷短链路 | `/code-review` -> `/handoff` -> `/team-review` | 范围清楚、无需复杂拆解 |
+| 测试先行开发 | `/team-plan` -> `/tdd` -> `/team-execute` | 想先锁测试和成功标准，再进入实现 |
+| 后端接口 + overlay 判断 | `/team-intake` -> `/team-plan` | 需要判断是否依赖自定义 overlay 扩展 |
+| 发布收口 | `/team-release` | 已有实现、自测和 QA 结论 |
+| specialist 结果回主链 | `/handoff` | 已经跑过 `/plan`、`/code-review`、`/verify` 等专项分析 |
+| 平台能力自检 | `/harness-audit` | 新增了命令、skills、hooks 或文档后，想看还有哪些入口未同步 |
+| 自定义 overlay 扩展专项 | 看 [../docs/runbooks/custom-overlay.md](../docs/runbooks/custom-overlay.md) | 需要叠加自定义 overlay |
+
+## 场景 1：新功能完整主链
+
+```text
+请按 Team Skills Platform 工作模型处理当前任务。
+先以 tech-lead 视角执行 /team-intake，输出目标、范围外事项、参与角色、主要风险和下一步建议。
+
+任务背景：
+- 目标：新增订单审批记录查询能力
+- 范围：接口、筛选条件、测试计划、最终 handoff
+- 不做：审批流程定义改造、历史数据回填
+- 约束：需要判断是否依赖 custom overlay 扩展
+```
+
+然后继续：
+
+```text
+基于当前 intake 结果继续执行 /team-plan。
+请拆出角色职责、依赖、handoff 节点、风险和技能装配清单。
+如果 custom overlay 不安装，也请明确写出未启用原因。
+```
+
+## 场景 2：小缺陷短链路
+
+```text
+这是一个边界清晰的小修复。
+请先判断是否可以走短链路；如果可以，按 /code-review -> /handoff -> /team-review 的顺序给出建议。
+如果不适合短链路，请说明必须补 /team-plan 的原因。
+
+任务：修复订阅页在 iPad 横屏下的布局溢出。
+范围：页面布局、响应式回归、UI 自测证据。
+不做：接口改造。
+```
+
+## 场景 3：后端接口 + overlay 判断
+
+```text
+请先以 /team-intake 方式处理当前后端任务，并重点判断是否命中 custom overlay 候选项。
+如果涉及私有流程、权限中心或公司专属平台，请给出候选项；如果不启用，也要说明原因。
+
+任务：新增订单审批状态流转接口与权限校验。
+范围：接口、权限、测试计划。
+不做：前端页面。
+```
+
+接着补一句：
+
+```text
+基于当前结果继续执行 /team-plan。
+请特别写清 architect、backend-engineer、qa-engineer 的依赖顺序，以及哪些字段必须进入最终 /handoff。
+```
+
+## 场景 4：测试先行开发
+
+```text
+基于当前任务先执行 /team-plan，拆出可测试的外部行为、边界态和最小交付物。
+然后继续执行 /tdd，给出 red-green-refactor 路径，并整理成可直接进入 /team-execute 的动作清单。
+
+任务：新增订单审批记录查询接口与列表页。
+范围：接口、页面、测试计划。
+不做：发布脚本重构。
+```
+
+## 场景 5：平台能力自检
+
+```text
+/harness-audit
+目标：检查当前平台的命令、skills、hooks、rules、文档和集成深度。
+输出：Overall Score、Dimension Scores、Top Actions、Recommendations。
+请再补一段：哪些结论需要回到 README、quick start、examples 或 team-skills-usage。
+```
+
+适用场景：你刚新增了一批命令、skills、hooks、runbook 或示例，想快速看“事实变了但说明没跟上”的部分。
+
+## 场景 6：发布收口
+
+```text
+基于当前实现、自测和 QA 结论，执行 /team-release。
+请输出发布方案、观察窗口、回滚条件、责任链，并补充是否需要私有发布或观测扩展。
+如果这些能力只是私有 runbook 补充，而不是正式 overlay 依赖，也请写清楚。
+```
+
+## 场景 7：specialist 结果回主链
+
+```text
+请不要停在专项结论。
+把上面的 /plan、/code-review 或 /verify 结果整理成可直接进入 /handoff 的格式。
+输出必须包含：已确认事项、未确认事项、风险、下一角色动作、是否需要补 /team-review 或 /team-release。
+```
+
+## 使用建议
+
+- 先写目标、范围、不做、约束，再发命令。
+- Claude 里 specialist 更适合做专项分析，不适合直接代替主链收口。
+- 如果你想知道 `/tdd`、`/harness-audit` 背后分别搭哪些能力，先看 [../docs/runbooks/command-and-capability-matrix.md](../docs/runbooks/command-and-capability-matrix.md)。
+- 如果你需要更短的命令骨架，回看 [../docs/runbooks/team-commands-quick-prompts.md](../docs/runbooks/team-commands-quick-prompts.md)。
+- 如果你想看完整成品对话，继续看 [../docs/runbooks/claude-end-to-end-conversation-example.md](../docs/runbooks/claude-end-to-end-conversation-example.md)。

package/examples/codex-conversation-script.md

@@ -0,0 +1,111 @@
+# Example Codex Conversation Script
+
+这份脚本适合第一次在 Codex 里跑“主链 + 并行分析 + 收口”时直接复制。
+
+## 场景 A：前端并行修复
+
+第一句：
+
+```text
+/team-intake
+目标：修复控制台首页在 iPad 横屏下的布局溢出
+范围：页面布局、响应式回归、UI 验证清单
+不做：接口与数据结构改造
+约束：必须遵守 frontend-quality-gates
+```
+
+第二句：
+
+```text
+/multi-frontend
+基于当前 intake 结果，从实现、UI/UX、QA 风险三个视角拆解工作。
+要求指出哪些结论必须进入最终 handoff。
+```
+
+第三句：
+
+```text
+请把上面的多 agent 结论整理成一次正式 /handoff。
+不要重复每个 agent 的原话，只保留已确认结论、风险与依赖、下一角色动作清单。
+```
+
+第四句：
+
+```text
+/team-execute
+按当前结论执行前端修复。
+输出改动摘要、自测结论、待 QA 关注点，以及需要进入 review 的内容。
+```
+
+第五句：
+
+```text
+/team-review
+基于当前 handoff 和 execute 结果，输出评审结论、阻塞项、放行建议和残余风险。
+```
+
+## 场景 B：复杂后端接口
+
+第一句：
+
+```text
+/team-intake
+目标：新增订单审批状态流转接口
+范围：接口、权限校验、测试计划
+不做：前端页面
+约束：如果命中自定义 overlay 扩展场景，先判断是否需要 enterprise overlay
+```
+
+第二句：
+
+```text
+/team-plan
+基于 intake 结果，拆解 architect、backend-engineer、qa-engineer 的职责，给出依赖和风险。
+```
+
+第三句：
+
+```text
+/multi-backend
+基于当前 intake 或 plan，把接口实现、权限边界、测试策略三部分并行分析。
+如果命中 custom overlay 或私有 runbook 扩展，请明确说明是正式启用、仅保留候选，还是按场景使用。
+最终请整理出可直接回写 /team-plan 的结果。
+```
+
+## 场景 C：测试先行开发
+
+第一句：
+
+```text
+/team-plan
+基于当前需求拆解实现任务，并给出适合进入 /tdd 的最小上下文。
+```
+
+第二句：
+
+```text
+/tdd
+目标：新增订单审批状态流转接口
+现有缺口：还没有测试先行路径和回归边界
+成功标准：给出 red-green-refactor 步骤，并整理成可直接回到 /team-execute 的动作清单
+```
+
+## 场景 D：平台能力自检
+
+第一句：
+
+```text
+/harness-audit
+目标：检查当前平台的命令、skills、hooks、rules、文档和集成深度。
+输出：Overall Score、Dimension Scores、Top Actions、Recommendations。
+请再补一段：哪些结论需要回到 README、quick start、examples 或 team-skills-usage。
+```
+
+## 使用建议
+
+- 并行前先做 intake，不要直接开跑多个 specialist
+- 并行后第一件事永远是收口到 handoff
+- 如果你想知道 `/tdd`、`/harness-audit` 分别适合什么任务，先看 [../docs/runbooks/specialist-commands-playbook.md](../docs/runbooks/specialist-commands-playbook.md)
+- 如果任务已经落到自定义 overlay 扩展场景，先看 [../docs/runbooks/custom-overlay.md](../docs/runbooks/custom-overlay.md) 和 [../docs/runbooks/custom-overlay.md](../docs/runbooks/custom-overlay.md)
+- 如果你想看更细的并行表达，继续看 [../docs/runbooks/codex-parallel-prompt-recipes.md](../docs/runbooks/codex-parallel-prompt-recipes.md)
+- 如果你想看完整成品对话，继续看 [../docs/runbooks/codex-end-to-end-conversation-example.md](../docs/runbooks/codex-end-to-end-conversation-example.md)