create-yss-spec 1.1.3 → 1.1.4

package/template/AGENTS.md

@@ -65,7 +65,9 @@ PRD 定义要做什么，OpenAPI 定义前后端契约，YSS 定义工程边界
 ```text
 yss-product-lifecycle
 -> competitive-intelligence (需要竞品 / 市场事实时)
+-> research (需要技术 / 标准 / API 一手资料时)
 -> grill-with-docs
+-> prototype (需要用一次性原型回答状态 / 逻辑 / UI 设计问题时)
 -> to-prd
 -> product overview design / functional architecture
 -> product-design:index
@@ -75,6 +77,7 @@ yss-product-lifecycle
 -> OpenSpec-style Spec Delta (中高风险行为变化时)
 -> OpenAPI Freeze
 -> to-issues
+-> handoff / implementation routing (跨线程、跨仓库或上下文过长时)
 -> implement / tdd
 -> code-review
 -> fresh verification
@@ -128,7 +131,9 @@ Matt skills 与 YSS skills 产物正文默认使用中文，包括澄清记录
 - 新产品、新模块或较大变更必须先判断生命周期阶段、缺失资产和下一步；可用 `yss-product-lifecycle`，已有等价记录时可复用。
 - 小需求变更或迭代不从头重跑完整链路；必须先做影响面评估，找到最近可信阶段，只补齐受影响阶段及其下游资产。
 - 任务开始前必须先参考 `docs/process/harness-process-tailoring.md` 判断小改动 / 中等变更 / 新模块或高风险变更；裁剪只能减少不相关产物，不能裁剪安全人审、Issue 追踪、Git checkpoint 和 fresh verification。
+- 需要技术事实、标准、第三方 API、框架行为或规范依据时，必须优先用 `research` 或等价一手资料调研形成可引用记录；市场 / 竞品事实仍优先用 `competitive-intelligence`。
 - 新功能或较大改动必须先用 `grill-with-docs` 澄清需求，再用 `to-prd` 形成 PRD，并在 PRD、实施计划或 Issue 中引用澄清记录。
+- 需求、状态机、复杂业务规则或 UI 方向无法仅靠文字收敛时，可用 `prototype` 做一次性逻辑 / UI 原型；原型结论必须回填到 PRD、设计、ADR 或 Issue，原型代码不得替代 YSS 必需的 Ant Design v6 高保真 HTML 原型。
 - PRD 基线阶段必须同步明确功能架构：功能域、模块边界、优先级、MVP / 非目标范围和模块依赖；不清晰时不得进入 PRD 校准。
 - 只要进入 PRD 初稿 / 需求基线流程，产品总体设计 / 功能架构就是必要产物，默认路径为 `docs/design/<feature>-product-overview-design.md`，且必须包含低保真原型 / 页面草图。不得直接从 PRD 初稿进入页面 / 原型 / 交互设计、OpenAPI Draft、PRD 校准、需求冻结或实现；不进入 PRD 生命周期的小文案、低风险 Bug 或局部配置变更，必须在影响面评估中说明不适用原因。
 - 涉及页面设计、原型评审、UI 实现、组件选型、主题 token、颜色排版间距或 Ant Design / YSS UI 风格一致性的任务，必须先用 `yss-design-system` 作为设计系统基线；详细规范引用 `docs/design/design-system.md`。
@@ -140,11 +145,14 @@ Matt skills 与 YSS skills 产物正文默认使用中文，包括澄清记录
 - 涉及持久化、Repository、元数据、版本、血缘、搜索或查询策略的变更，必须在开发前产出数据架构；数据模型、元数据管理、ER 设计、版本管理或血缘分析类产品必须在 Design Review 和 OpenAPI Freeze 前完成数据架构。
 - 进入实现前，必须先判断当前需求涉及的前端 / 后端运行时代码工程是否已存在且可复用；若不存在、不可复用或目录约定缺失，必须先在 implementation routing 中记录原因，并路由到 `yss-ddd-scaffold-generator` 或 `yss-frontend-scaffold-generator` 初始化对应脚手架后再进入业务实现。
 - 进入实现前，必须把系统架构、数据架构、ADR、工程基线、OpenAPI Freeze 结论和安全红线转译为当前切片的 `Build Architecture Checklist`。
+- 跨线程、跨仓库、上下文接近上限、原型分支回流或实现仓库交接时，必须使用 `handoff` 或等价交接记录，写清来源资产、当前阶段、未决问题、验证命令和下一步责任人。
 - 每个垂直切片完成时必须回勾 `Build Architecture Checklist`：已落实项给出代码、测试或文档证据；延期项说明原因、风险、补齐切片和是否允许继续；漂移项必须触发 Architecture Re-check；违反项必须停止实现并回到设计审查或架构修正。
 - 涉及 Repository / Gateway / 持久化边界、权限 / 认证 / 授权、审计日志、SQL / DDL / 迁移、文件上传下载 / 临时 URL、版本快照 / 元数据 / 血缘 / 查询索引、跨模块接口、部署、回滚或运维约束时，必须在当前切片的实现记录中写明架构对齐状态和 `TODO-HUMAN-REVIEW` 补齐落点。
 - 当需求、架构、流程、状态机、数据流或垂直切片关系仅靠文字难以说明时，可用 `excalidraw-diagram-generator` 生成 `.excalidraw` 图作为辅助材料；图不能替代 PRD、OpenAPI、ADR 或测试。
 - 任何 Bug、测试失败或性能回退必须先用 `diagnosing-bugs` 建立可复现反馈命令，再修复。
+- 处理 merge / rebase 冲突时必须使用 `resolving-merge-conflicts` 或等价流程：理解双方意图、保留真实目的、重新运行相关检查，并记录取舍。
 - 业务行为实现默认使用 `tdd`：先写一个会失败的行为测试并确认失败，再写最小实现；生成代码、配置或一次性原型如不适用 TDD，必须明确例外原因和验证方式。
+- 修改 YSS / Matt skill、AGENTS 规则或流程模板时，必须按 `writing-skills` 的思路给出压力场景或验证方式，避免只增加不可执行的文字规则。
 - 架构治理、难测模块、深模块设计必须使用 `improve-codebase-architecture` / `codebase-design` 的 module、interface、seam、adapter 术语。
 - `to-issues` 产出的任务必须是端到端垂直切片，不允许只按 Adapter / Application / Domain / Infrastructure 横向拆分。
 - 每个生命周期阶段完成后必须执行 Git checkpoint 判断：列出阶段产物、Issue 同步状态、排除无关脏文件，并在用户已授权时按范围提交和推送。

package/template/docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md

@@ -11,11 +11,11 @@ Matt Pocock Engineering Skills 是一组小而可组合的工程工作流。本
 
 | 本模板层级 | 默认能力 | 说明 |
 |---|---|---|
-| 需求与任务 | `competitive-intelligence`、`grill-with-docs`、`to-prd`、`to-issues` | 收集竞品 / 市场事实、澄清需求、沉淀 PRD、拆端到端垂直切片 |
+| 需求与任务 | `competitive-intelligence`、`research`、`grill-with-docs`、`prototype`、`to-prd`、`to-issues` | 收集竞品 / 市场 / 技术事实、澄清需求、用一次性原型回答设计问题、沉淀 PRD、拆端到端垂直切片 |
 | 契约层 | OpenAPI 3.1 Draft / Freeze、OpenSpec-style Spec Delta | 前后端契约、行为差异、验收场景和契约测试输入 |
 | 方法论层 | `implement`、`tdd`、`diagnosing-bugs`、`code-review` | 实现、红绿重构、Bug 诊断和独立审查 |
 | 架构与领域 | `domain-modeling`、`codebase-design`、`improve-codebase-architecture` | 领域语言、深模块设计、架构治理 |
-| 协作层 | `triage`、Issue tracker、Git checkpoint | 分诊、同步状态、记录验证证据 |
+| 协作层 | `triage`、`handoff` / 等价交接记录、Issue tracker、Git checkpoint | 分诊、跨线程 / 跨仓库交接、同步状态、记录验证证据 |
 
 ## 2. 标准执行流程
 
@@ -24,7 +24,7 @@ Matt Pocock Engineering Skills 是一组小而可组合的工程工作流。本
 | 项 | 内容 |
 |---|---|
 | 触发语 | “做一个功能”、“把这个想法落成需求”、“生成 PRD/Issue”、“可以开始实现” |
-| 使用 skills | `competitive-intelligence`（需要竞品 / 市场事实时）、`grill-with-docs`、`domain-modeling`、`to-prd`、`to-issues`、`implement`、`tdd`、`code-review` |
+| 使用 skills | `competitive-intelligence`（需要竞品 / 市场事实时）、`research`（需要技术 / 标准 / API 一手资料时）、`grill-with-docs`、`prototype`（需要一次性验证时）、`domain-modeling`、`to-prd`、`to-issues`、`implement`、`tdd`、`code-review` |
 | 输入 | 业务想法、发现报告、用户故事草案、干系人讨论记录 |
 | 输出 | PRD、OpenAPI 3.1 Spec、垂直切片 Issue、实现与测试 |
 | 落点 | `docs/requirements/`、`docs/api/specs/`、GitLab / GitHub Issues、`CONTEXT.md`、`docs/adr/` |
@@ -34,7 +34,9 @@ Matt Pocock Engineering Skills 是一组小而可组合的工程工作流。本
 
 ```text
 competitive-intelligence (when market / competitor facts are needed)
+  -> research (when technical / standards / API primary sources are needed)
   -> grill-with-docs
+  -> prototype (when a design question needs runnable feedback)
   -> domain-modeling
   -> to-prd
   -> OpenAPI 3.1 Draft
@@ -43,6 +45,7 @@ competitive-intelligence (when market / competitor facts are needed)
   -> Architecture / Data Design Review
   -> OpenAPI 3.1 Freeze
   -> to-issues
+  -> handoff / implementation routing (when crossing contexts or repos)
   -> implement with tdd
   -> code-review / fresh verification
 ```
@@ -50,12 +53,15 @@ competitive-intelligence (when market / competitor facts are needed)
 门禁：
 
 - PRD 进入开发前必须明确用户故事、验收条件、OpenAPI 影响和测试决策。
+- 技术 / 标准 / 第三方 API 事实影响 PRD、OpenAPI、架构或验收时，必须有 `research` 或等价一手资料记录，并在下游资产中引用。
+- 一次性 `prototype` 只回答设计问题；结论必须回填到 PRD、设计、ADR 或 Issue，原型代码不得作为生产实现或 YSS 高保真 HTML 原型交付。
 - 任何 API 变更必须先在 `docs/api/specs/*.yaml` 形成 Draft，经工程基线、系统 / 数据架构和设计审查后 Freeze，再进入实现。
 - API、权限、状态机、数据模型、跨端、新模块或高风险行为变化，应在 Design Review / OpenAPI Freeze 前补 OpenSpec-style Spec Delta；它只描述行为差异、验收场景和测试映射，不恢复 OpenSpec 工具链。
 - OpenAPI Freeze 后进入 `to-issues` 或等价垂直切片拆分；Issue 必须可以独立 demo 或验证。
 - 后端新服务或新模块必须先确认 YSS DDD 工程基线；从零创建服务时优先使用 `yss-ddd-scaffold-generator`。
 - `to-issues` 只能产出可独立验证的垂直切片，不允许只按 Adapter / Application / Domain / Infrastructure 横向拆分。
 - 涉及安全红线时，Issue 必须标注 `ready-for-human` 或 `TODO-HUMAN-REVIEW`。
+- 跨线程、跨仓库、上下文接近上限或原型分支回流时，必须留下 `handoff` 或等价交接记录。
 
 ### 2.2 Bug 修复流程
 
@@ -126,7 +132,9 @@ competitive-intelligence (when market / competitor facts are needed)
 |---|---|---|---|
 | `ask-matt` | 不确定该走哪个流程 | 路由到合适 skill | 作为入口说明 |
 | `competitive-intelligence` | 需要竞品、替代方案、定价、定位、用户口碑或市场事实 | 基于公开来源形成竞品情报、证据表、竞品矩阵和 PRD 输入 | `docs/discovery/reports/` |
+| `research` | 需要技术事实、标准、第三方 API、框架行为或官方文档依据 | 基于一手来源形成可引用调研记录 | `docs/discovery/reports/` 或 `docs/research/` |
 | `grill-with-docs` | 想法还不清晰，需要追问 | 结合领域建模持续追问，沉淀 glossary / ADR | `CONTEXT.md`、`docs/adr/` |
+| `prototype` | 状态机、复杂规则或 UI 方向需要可运行反馈 | 生成一次性逻辑 / UI 原型并沉淀结论 | PRD、设计、ADR 或 Issue 的结论章节 |
 | `to-prd` | 已有对话，需要整理成 PRD | 不再访谈，直接合成 PRD 并发布到 issue tracker | `docs/requirements/` 或 Issue |
 | `to-issues` | PRD / 计划需要拆任务 | 拆成可独立领取的垂直切片 Issue | Issue tracker |
 | `implement` | 按 PRD 或 Issue 实现 | 业务行为默认按 TDD 推进；生成代码、配置或一次性原型说明例外和验证方式；最后 independent review + fresh verification + commit | 当前代码分支 |
@@ -168,6 +176,9 @@ competitive-intelligence (when market / competitor facts are needed)
 | Sprint / Standup / Retro | `docs/process/` |
 | Issue tracker 配置 | `docs/agents/` |
 | 领域词汇表 | 根目录 `CONTEXT.md` |
+| 技术 / 标准 / API 调研 | `docs/discovery/reports/` 或 `docs/research/` |
+| 一次性原型结论 | PRD、设计、ADR 或垂直切片 Issue |
+| 跨线程 / 跨仓库交接 | Issue / MR / PR 评论或 `docs/implementation/` |
 
 ## 5. 门禁与验收规则
 
@@ -195,3 +206,11 @@ competitive-intelligence (when market / competitor facts are needed)
 - [ ] TDD 适用性已明确；若例外，说明验证方式。
 - [ ] 安全红线和人审点已标注。
 - [ ] 实现仓库、分支、测试命令和回滚点清楚。
+- [ ] 跨线程 / 跨仓库 / 原型回流场景已有 `handoff` 或等价交接记录。
+- [ ] 如发生 merge / rebase 冲突，已有冲突处理取舍和重新验证证据。
+
+### 5.4 Process / Skill Ready
+
+- [ ] 修改 AGENTS、流程模板或 skill 时，已按 `writing-skills` 思路列出至少一个压力场景或验证方式。
+- [ ] 新规则触发条件清楚，避免把条件技能变成所有任务的硬门禁。
+- [ ] 下游资产位置、引用方式和不适用条件明确。

package/template/docs/process/harness-process-tailoring.md

@@ -17,14 +17,18 @@
 | 当前输入 / 变更事实 | 最近可信阶段 | 需要补齐的下游 |
 |---|---|---|
 | 只有模糊想法、业务机会或竞品输入 | 2. 机会与 Discovery | Discovery、`grill-with-docs`、PRD、产品总体设计 / 功能架构 |
+| 需要技术事实、标准、第三方 API 或框架行为支撑决策 | 2. 机会与 Discovery 或 5. 系统 / 数据架构与工程契约设计审查 | `research` 或等价一手资料记录，并回填到 PRD、OpenAPI、架构或 ADR |
 | 已有清晰 PRD，但用户、痛点、MVP 或非目标不稳 | 3. 业务 / PRD / 功能架构 | PRD Review、产品总体设计 / 功能架构、必要的页面 / 原型 / 交互设计 |
+| 状态机、复杂规则或 UI 方向无法仅靠文字判断 | 3. 业务 / PRD / 功能架构 或 4. 产品设计与需求冻结 | `prototype` 一次性验证结论，并回填到 PRD / 设计 / ADR / Issue |
 | 有 UI 变更但缺页面流、状态矩阵、原型评审、高保真 HTML 原型、AntD CLI 校验证据或用户确认记录 | 4. 产品设计与需求冻结 | 交互说明、状态矩阵、Prototype Review、Ant Design v6 高保真 HTML 原型（可在低保真评审通过后由系统 / Agent 自动产出）、AntD CLI 校验证据、用户确认记录、PRD 回填 |
 | API 路径、schema、错误结构、分页或权限发生变化 | 5. 系统 / 数据架构与工程契约设计审查 | API 影响记录、契约草案 / OpenAPI Draft Review、必要时 Spec Delta、系统 / 数据架构反审、Freeze、`to-issues` |
 | 服务边界、集成、部署、性能、可靠性或运维变化 | 5. 系统 / 数据架构与工程契约设计审查 | 系统架构、Design Review、必要时 Spec Delta、Build Architecture Checklist |
 | 持久化、元数据、版本、血缘、搜索、索引或迁移变化 | 5. 系统 / 数据架构与工程契约设计审查 | 数据架构、必要时 Spec Delta、人审点、Repository / MyBatis 前置审查 |
 | OpenAPI 已冻结但还没有垂直切片 Issue | 6. 契约冻结与 Issue formalization | `to-issues`、实施计划、Build Architecture Checklist |
 | 已有垂直切片 Issue，但实现准备不完整 | 7. 垂直切片与 TDD 实现 | 实施计划、YSS skill routing、测试命令、回滚点 |
+| 跨线程、跨仓库、上下文过长或原型分支需要回流 | 7. 垂直切片与 TDD 实现 | `handoff` 或等价交接记录、实现仓库绑定、验证命令 |
 | 只有代码修复或测试失败 | 7. 垂直切片与 TDD 实现 | 可复现命令、失败测试、最小修复、fresh verification |
+| merge / rebase 冲突阻塞交付 | 7. 垂直切片与 TDD 实现 | `resolving-merge-conflicts` 或等价冲突处理记录、重新验证 |
 | 准备发布或宣称完成 | 8. 验证发布与复盘 | fresh verification、发布说明、回滚方案、复盘入口 |
 
 ## 升级条件
@@ -37,6 +41,8 @@
 - 服务边界、外部系统集成、部署、回滚、可观测性、性能、可靠性或运维约束变化。
 - UI 变更影响用户主流程、权限状态、异常状态、页面导航或 OpenAPI 反推清单。
 - 实现与既有架构、CONTEXT 术语、ADR、PRD 或垂直切片 Issue 出现漂移。
+- 技术事实、标准或第三方 API 判断会影响 PRD、OpenAPI、架构、验收或发布风险，且当前没有一手资料记录。
+- 当前工作需要跨线程、跨仓库、原型分支回流或上下文交接，但没有 handoff / 等价交接记录。
 - 无法给出 fresh verification 证据。
 
 ## 裁剪原则
@@ -45,5 +51,6 @@
 - 中等变更只补受影响阶段及其下游，不回到机会探索。
 - 小改动必须保留影响面评估、验证证据和 Git checkpoint 判断。
 - 小改动默认不创建 Spec Delta；只有扩散到 API、权限、状态机、数据模型、跨端或安全红线时才升级补齐。
+- 小改动默认不需要 `research`、`prototype` 或 `handoff`；只有事实依据、设计验证或交接风险会影响后续门禁时才触发。
 - 安全红线只能进入人工审查或草案状态，不能因任务小而跳过。
 - OpenAPI Freeze 后直接进入 `to-issues` 或等价垂直切片拆分；不要求额外变更状态文件。

package/template/docs/process/lifecycle-artifact-map.md

@@ -21,13 +21,13 @@ owner: ai
 | 主阶段 | 目标 | 必须产物 | 条件产物 | 下一门禁 |
 |---|---|---|---|---|
 | 1. 入口分诊 | 判断任务类型、风险等级、最近可信阶段和最小技能集 | 分诊结论或 issue 备注 | `yss-product-lifecycle` 路由结果、Git checkpoint 判断 | 是否需要 Discovery / PRD / API / 架构 / Issue |
-| 2. 机会与 Discovery | 收敛用户、痛点、为什么现在做、MVP、非目标、成功标准、产品功能指引和下游影响信号 | `docs/discovery/<feature>-discovery.md` 或等价说明 | `competitive-intelligence` 竞品情报、竞品矩阵、机会说明、产品功能指引、下游影响清单、市场分析、用户痛点文档 | 是否足以进入业务架构和 PRD |
-| 3. 业务 / PRD / 功能架构 | 明确产品边界、用户旅程、功能域、模块边界、优先级、低保真原型和验收标准 | `docs/requirements/<feature>-prd.md`；`docs/design/<feature>-product-overview-design.md` | `grill-with-docs` 澄清记录、业务架构、CONTEXT 术语回填；不进入 PRD 生命周期的小改动可记录不适用原因 | PRD Review / 产品总体设计评审 / 产品设计准备度 |
+| 2. 机会与 Discovery | 收敛用户、痛点、为什么现在做、MVP、非目标、成功标准、产品功能指引和下游影响信号 | `docs/discovery/<feature>-discovery.md` 或等价说明 | `competitive-intelligence` 竞品情报、`research` 技术 / 标准 / API 一手资料记录、竞品矩阵、机会说明、产品功能指引、下游影响清单、市场分析、用户痛点文档 | 是否足以进入业务架构和 PRD |
+| 3. 业务 / PRD / 功能架构 | 明确产品边界、用户旅程、功能域、模块边界、优先级、低保真原型和验收标准 | `docs/requirements/<feature>-prd.md`；`docs/design/<feature>-product-overview-design.md` | `grill-with-docs` 澄清记录、`prototype` 一次性验证结论、业务架构、CONTEXT 术语回填；不进入 PRD 生命周期的小改动可记录不适用原因 | PRD Review / 产品总体设计评审 / 产品设计准备度 |
 | 4. 产品设计与需求冻结 | 基于 PRD 初稿和产品总体设计，对 UI、页面流、状态矩阵、异常路径、高保真体验和 PRD 回填做闭环 | 有 UI 时：交互说明、低保真原型评审结论、Ant Design v6 高保真 HTML 原型（可由系统 / Agent 在低保真评审通过后自动产出）、AntD CLI 校验证据和用户确认记录；无 UI 时：需求冻结记录 | 状态矩阵、页面地图、原型链接 | PRD 校准 / 工程契约与架构设计准备度 |
 | 5. 系统 / 数据架构与工程契约设计审查 | 合并 API 影响分析、契约草案、工程基线、系统架构、数据架构和 Design Review；Draft 仅用于评审，Freeze 前不得作为实现或生成客户端契约 | 系统概要设计或等价架构记录；Design Review 结论；有 API 时：API 影响记录和契约草案 / review-only OpenAPI Draft；有后端结构影响时：工程基线审查 | OpenAPI Draft Review、OpenSpec-style Spec Delta、工程基线审查、无 API 影响记录、数据架构、ADR、架构图 | OpenAPI Freeze 准备度 |
 | 6. 契约冻结与 Issue formalization | 冻结契约并把交付范围转成可执行 Issue，并明确受影响前后端工程是否已存在 | OpenAPI Freeze 记录或无 API 影响记录；垂直切片 Issue 入口 | `to-issues` 输出、实施路由记录、实现仓库 / 脚手架判定、Issue tracker 同步 | 垂直切片准备度 |
-| 7. 垂直切片与 TDD 实现 | 将冻结范围拆成端到端切片并按 TDD 实现 | 垂直切片 Issue、实施计划、Build Architecture Checklist、测试 / 验证记录 | YSS skill routing、前后端脚手架初始化记录、`implement` / `tdd` 证据、`code-review` 报告、清理简化记录、Architecture Re-check | Fresh verification / Release Review |
-| 8. 验证发布与复盘 | 保留发布、实施、验证和经验沉淀证据 | fresh verification、发布说明、复盘记录 | 实施记录、用户手册、AGENTS / CONTEXT / ADR 更新 | 下一轮规划 |
+| 7. 垂直切片与 TDD 实现 | 将冻结范围拆成端到端切片并按 TDD 实现 | 垂直切片 Issue、实施计划、Build Architecture Checklist、测试 / 验证记录 | YSS skill routing、前后端脚手架初始化记录、`handoff` / 跨仓库交接记录、`implement` / `tdd` 证据、`code-review` 报告、`resolving-merge-conflicts` 记录、清理简化记录、Architecture Re-check | Fresh verification / Release Review |
+| 8. 验证发布与复盘 | 保留发布、实施、验证和经验沉淀证据 | fresh verification、发布说明、复盘记录 | 实施记录、用户手册、`writing-skills` 压力场景 / 流程修订验证、AGENTS / CONTEXT / ADR 更新 | 下一轮规划 |
 
 ## 21 个门禁 / 职责点映射
 
@@ -50,7 +50,7 @@ owner: ai
 | 14. Issue formalization | 6. 契约冻结与 Issue formalization | 垂直切片 Issue、`to-issues` 输出或等价任务记录，并记录受影响前后端工程存在性判定与脚手架初始化决策 | 正式垂直切片前必需 |
 | 15. 实施计划 | 7. 垂直切片与 TDD 实现 | 垂直切片 Issue、实施计划、Build Architecture Checklist、回滚点，以及缺失前后端工程时的脚手架初始化记录 | 正式开发前必需 |
 | 16. 开发实现 | 7. 垂直切片与 TDD 实现 | TDD 证据、代码实现、契约对齐、架构约束回勾 | 代码变更时必需 |
-| 17. 独立审查 | 7. 垂直切片与 TDD 实现 | Review Report、`code-review` 结论或 MR / PR 评论 | 合并 / 发布前必需 |
+| 17. 独立审查 | 7. 垂直切片与 TDD 实现 | Review Report、`code-review` 结论或 MR / PR 评论；发生 merge / rebase 冲突时补 `resolving-merge-conflicts` 记录 | 合并 / 发布前必需 |
 | 18. 清理简化 | 7. 垂直切片与 TDD 实现 | 清理项记录或 review 建议 | 有复用 / 可读性 / 性能问题时执行 |
 | 19. 验证发布 | 8. 验证发布与复盘 | fresh verification、发布说明、实施 / 回滚说明 | 发布 / 可合并结论前必需 |
 | 20. 复盘沉淀 | 8. 验证发布与复盘 | 复盘、CONTEXT / AGENTS / ADR 更新 | 发布后或阶段性复盘时必需 |
@@ -62,6 +62,7 @@ owner: ai
 | Discovery 收敛 | `docs/discovery/<feature>-discovery.md` | `docs/discovery/templates/discovery-template.md` |
 | 竞品情报简报 | `docs/discovery/reports/<feature>-competitive-intelligence.md` | `competitive-intelligence` 输出格式 |
 | 竞品矩阵 | `docs/discovery/reports/<feature>-competitive-matrix.md` | `docs/discovery/templates/competitive-matrix-template.md` |
+| 技术 / 标准 / API 调研 | `docs/discovery/reports/<feature>-research.md` 或 `docs/research/<feature>.md` | `research` 输出格式 |
 | PRD | `docs/requirements/<feature>-prd.md` | `docs/templates/prd-template.md` |
 | 业务架构 | `docs/architecture/<feature>-business-architecture.md` | `docs/architecture/templates/business-architecture-template.md` |
 | 功能架构 | `docs/architecture/<feature>-functional-architecture.md` | `docs/architecture/templates/functional-architecture-template.md` |
@@ -82,6 +83,7 @@ owner: ai
 | OpenAPI Freeze | `docs/api/<feature>-openapi-freeze.md` | `docs/api/templates/openapi-freeze-record-template.md` |
 | 垂直切片 Issue | GitLab / GitHub Issues 或 `docs/requirements/issues/<feature>-slice.md` | `docs/templates/vertical-slice-issue-template.md` |
 | 实现路由 | `docs/requirements/issues/<feature>-implementation-routing.md` | `docs/templates/implementation-routing-template.md` |
+| 跨阶段 / 跨仓库交接 | Issue / MR / PR 评论或 `docs/implementation/<feature>-handoff.md` | `handoff` 或等价交接记录 |
 | 实现仓库登记 | 实施计划 / Issue / `docs/implementation/<feature>-repo-registry.md` | `docs/templates/implementation-repo-registry-template.md` |
 | 跨仓库切片记录 | 垂直切片 Issue / `docs/implementation/<feature>-cross-repo-slice.md` | `docs/templates/cross-repo-slice-template.md` |
 | Build Architecture Checklist | `docs/implementation/<feature>-build-architecture-checklist.md` 或实施计划 / Issue | `docs/templates/build-architecture-checklist-template.md` |
@@ -91,6 +93,7 @@ owner: ai
 | 实施记录 | `docs/implementation/<feature>-rollout.md` | `docs/templates/implementation-plan-template.md` |
 | 用户手册 | `docs/user-guide/<feature>.md` | `docs/user-guide/templates/user-guide-template.md` |
 | 复盘 | `docs/process/sprint-retros/<date>-<topic>.md` | `docs/templates/retro-report-template.md` |
+| 流程 / Skill 修订验证 | `docs/process/<topic>-skill-validation.md` 或 PR / Issue 评论 | `writing-skills` 压力场景与验证记录 |
 | Harness 工作单元映射 | `docs/process/harness-work-unit-map.md` | 直接维护 |
 | Harness 流程裁剪 | `docs/process/harness-process-tailoring.md` | 直接维护 |
 | 阶段 checkpoint | Issue / MR / PR 评论或阶段文档 | `docs/process/templates/stage-checkpoint-template.md` |
@@ -100,15 +103,20 @@ owner: ai
 - 每次开始前先判断任务类型和最近可信阶段；不要把小文案、局部样式、单点 Bug 套进完整新功能流程。
 - 判断流程裁剪时先引用 `docs/process/harness-process-tailoring.md`；该指南只能减少不相关产物，不能裁剪关键追踪关系、安全人审或 fresh verification。
 - Discovery 可以通过 `competitive-intelligence` 形成竞品情报、竞品矩阵、机会说明、产品功能指引和下游影响清单，但这些只是 PRD、功能架构、产品设计、API 和架构阶段的输入，不冻结后续设计。
+- 技术事实、框架行为、标准、第三方 API 或协议依据需要可追溯时，使用 `research` 或等价一手资料调研记录；其结论是 PRD、OpenAPI、架构或 ADR 的输入，不替代这些阶段资产。
+- 状态机、复杂业务规则或 UI 方向难以文字定稿时，可用 `prototype` 做一次性验证；必须把结论回填到 PRD、设计、ADR 或 Issue，且不得把 throwaway prototype 当作生产实现或高保真 AntD HTML 原型。
 - API 相关阶段必须区分“契约草案 / OpenAPI Draft”和“OpenAPI Freeze”：Draft 仅可用于评审和架构反审，Freeze 前不得作为前后端实现或生成客户端的稳定契约。
 - OpenSpec-style Spec Delta 只用于表达行为差异、验收场景和测试映射；它不替代 PRD、OpenAPI、Design Review 或垂直切片 Issue，也不要求创建额外变更目录。
 - API、权限、状态机、数据模型、跨端、新模块或高风险变更应在 Design Review / OpenAPI Freeze 前补充 Spec Delta；小文案、局部样式、配置微调和低风险 Bug 默认跳过。
 - OpenAPI Freeze 后直接进入 `to-issues` 或等价垂直切片拆分，不再要求额外变更目录或状态文件。
 - 进入实现前，必须先判断当前切片受影响的 frontend / backend 运行时代码工程是否已经存在且可复用；若不存在、不可复用或目录约定缺失，必须先记录原因并路由 `yss-ddd-scaffold-generator` 或 `yss-frontend-scaffold-generator` 初始化，再进入业务实现。
 - 进入垂直切片实现前，必须将系统架构、数据架构、ADR、工程基线、OpenAPI Freeze 结论和安全红线转译成 `Build Architecture Checklist`。
+- 跨线程、跨仓库、上下文过长或原型结论回流时，必须留下 `handoff` 或等价交接记录，至少包含来源资产、当前阶段、未决问题、验证命令和下一步责任人。
 - 每个垂直切片完成时必须回勾 `Build Architecture Checklist`，用 `implemented`、`seam-deferred`、`drift`、`violation` 或 `not-applicable` 标记状态，并提供证据或补齐落点。`drift` 触发 Architecture Re-check；`violation` 阻断继续 build。
 - Repository / Gateway / 持久化、权限 / 授权、审计、SQL / DDL / 迁移、文件上传下载、版本快照 / 元数据 / 血缘 / 查询索引、部署 / 回滚 / 运维约束，必须在 checklist 中逐项绑定切片和人审要求。
 - 每个主阶段结束都要做 issue tracker 同步：按用户明确选择或当前仓库主远端路由到 GitLab / GitHub，更新对应 PRD、垂直切片 Issue、里程碑或评论，记录阶段状态、完成范围、验证证据、阻塞项、下一步和安全人审点。
 - 每个主阶段结束都要做 Git checkpoint 判断：列出变更产物、Issue 同步状态、排除无关脏文件，并说明提交 / 推送 / 暂缓原因。
 - 触碰安全红线时，模板中必须标记 `TODO-HUMAN-REVIEW`，Agent 只能生成草案。
 - 任何“完成 / 可合并 / 可发布”结论必须有 fresh verification 证据。
+- 发生 merge / rebase 冲突时，必须按 `resolving-merge-conflicts` 或等价流程记录双方意图、取舍和重新验证结果。
+- 修改 AGENTS、流程模板或技能说明时，必须按 `writing-skills` 思路补充压力场景或验证说明，避免流程规则只停留在不可执行文字。

package/template/scripts/verify-template

@@ -38,27 +38,14 @@ matt_skill_roots=(
 )
 
 removed_flow_paths=(
-  ".comet"
   "docs/superpowers"
   "openspec"
-  ".codex/rules/comet-phase-guard.md"
-  ".claude/rules/comet-phase-guard.md"
-  ".trae/rules/comet-phase-guard.md"
-  ".pi/extensions/comet-commands.ts"
   ".agent/workflows"
   ".claude/commands/opsx"
   ".pi/prompts"
 )
 
 removed_skill_names=(
-  "comet"
-  "comet-archive"
-  "comet-build"
-  "comet-design"
-  "comet-hotfix"
-  "comet-open"
-  "comet-tweak"
-  "comet-verify"
   "openspec-apply-change"
   "openspec-archive-change"
   "openspec-bulk-archive-change"
@@ -98,7 +85,6 @@ legacy_text_paths=(
 legacy_text_patterns=(
   "active change"
   "openspec/changes"
-  ".comet.yaml"
   "openspec list"
   "test-driven-development"
   "requesting-code-review"

package/template/skills-lock.json

@@ -1,28 +1,23 @@
 {
   "version": 2,
-  "source": {
-    "name": "mattpocock/skills",
-    "sourceType": "github",
-    "ref": "272f99b22574f50e4266791c86b9302682970e23",
-    "path": "skills/engineering"
-  },
-  "additionalSources": {
-    "competitive-intelligence": {
-      "name": "anthropics/knowledge-work-plugins",
-      "sourceType": "github",
-      "ref": "main",
-      "path": "sales/skills/competitive-intelligence"
-    }
-  },
   "skills": {
     "ask-matt": {
-      "skillPath": "skills/engineering/ask-matt/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/ask-matt/SKILL.md",
+      "computedHash": "2d3f523c8bf1ebbd4d5ecaa1e2678ec629f157248669f1edba807de1d0feb031"
     },
     "code-review": {
-      "skillPath": "skills/engineering/code-review/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/code-review/SKILL.md",
+      "computedHash": "4a17d9d3e0fc87ae48544d371a820fac5a4a78f4c05e7e6b3229094fbf8a7e26"
     },
     "codebase-design": {
-      "skillPath": "skills/engineering/codebase-design/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/codebase-design/SKILL.md",
+      "computedHash": "2426dc4accf1a85dedfb560edb3a877ec8828b7375ea08c970df2b6c900a2a22"
     },
     "competitive-intelligence": {
       "skillPath": "sales/skills/competitive-intelligence/SKILL.md",
@@ -32,40 +27,88 @@
       "skillPath": "skills/engineering/diagnosing-bugs/SKILL.md"
     },
     "domain-modeling": {
-      "skillPath": "skills/engineering/domain-modeling/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/domain-modeling/SKILL.md",
+      "computedHash": "67343881f5def98487d56243155716110afbcbf22ec92421c882d532b941cb17"
+    },
+    "grill-me": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/productivity/grill-me/SKILL.md",
+      "computedHash": "f321507f77702a54af1db66549ec1685fc625390d06c57d7949cdcda8eb1b5c7"
     },
     "grill-with-docs": {
-      "skillPath": "skills/engineering/grill-with-docs/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/grill-with-docs/SKILL.md",
+      "computedHash": "e7ef25bbee50cda2eb7b3a8ef541db0a0396dad7d369f7d14fb610671dd1864b"
+    },
+    "grilling": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/productivity/grilling/SKILL.md",
+      "computedHash": "1de9e777a60b184b29412fadacb7bbde8c14bb7037e5c4d9d086c941281d1742"
+    },
+    "handoff": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/productivity/handoff/SKILL.md",
+      "computedHash": "5d0f81e38abe6b984e1feaa731927de5291d040982106ac513cf54ec240e00ec"
     },
     "implement": {
       "skillPath": "skills/engineering/implement/SKILL.md"
     },
     "improve-codebase-architecture": {
-      "skillPath": "skills/engineering/improve-codebase-architecture/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/improve-codebase-architecture/SKILL.md",
+      "computedHash": "8bf292143ca93b00276a0de0fc5f84f2381f4690c5b0d32e99fa283a072f392f"
     },
     "prototype": {
-      "skillPath": "skills/engineering/prototype/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/prototype/SKILL.md",
+      "computedHash": "e70c8933d30153a4da47865829d356824b2a830367275e3b00c7b431a1544a79"
     },
     "research": {
-      "skillPath": "skills/engineering/research/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/research/SKILL.md",
+      "computedHash": "87d17f5103899fbe179b552a85485d50f2316ca5b3128f5716af7d88817533e1"
     },
     "resolving-merge-conflicts": {
       "skillPath": "skills/engineering/resolving-merge-conflicts/SKILL.md"
     },
     "setup-matt-pocock-skills": {
-      "skillPath": "skills/engineering/setup-matt-pocock-skills/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/setup-matt-pocock-skills/SKILL.md",
+      "computedHash": "a7d798f49081ea5b2606e8bcafa3bc2b34177cfaa24d71c2ddf2d433f4006a4a"
     },
     "tdd": {
-      "skillPath": "skills/engineering/tdd/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/tdd/SKILL.md",
+      "computedHash": "c9326b88419cfba1d54dd713b7ddb23020e6a93f4b0d13aea58cebba58cda2ee"
     },
     "to-issues": {
-      "skillPath": "skills/engineering/to-issues/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/to-issues/SKILL.md",
+      "computedHash": "4406ded5e0fb356b9ac8be777270f62d3c5d206a0bc848aaadb19919702a1892"
     },
     "to-prd": {
-      "skillPath": "skills/engineering/to-prd/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/to-prd/SKILL.md",
+      "computedHash": "5a733e19d825f22e83de52e68b8840c9fd2fa7501282277a122c1aa28a922059"
     },
     "triage": {
-      "skillPath": "skills/engineering/triage/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/triage/SKILL.md",
+      "computedHash": "b77ea99c2e6e97815b373cc476ad4cc1835d3e736867b764602147be71f6c131"
     }
   }
 }

package/template/.codex/skills/yss-anti-scheduler/SKILL.md

@@ -1,53 +0,0 @@
----
-name: yss-anti-scheduler
-description: 用于 YSS anti-corrosion anti-scheduler、DolphinScheduler SDK、调度器 API client、工作流/任务/租户/资源中心客户端接入和排障。
----
-
-# yss-anti-scheduler
-
-Use this skill for YSS 调度器防腐层组件. Keep implementation grounded in the local project and resolvable YSS backend component source.
-
-中文说明：本技能用于 YSS 调度器防腐层组件，覆盖统一 Scheduler API 以及 DolphinScheduler、DM Scheduler、XXL-JOB、ElasticJob 等后端适配。执行时优先读取源码索引，避免凭记忆猜类名、配置项或接入方式。
-
-## Source Index First
-
-- Backend source location is environment-specific; resolve it with `yss-source-index/references/source-location.md`.
-- Generated index: `references/source-index.md`
-- Component path hints: `yss-microservice-components/yss-component-anti-corrosion/yss-component-anti-scheduler`
-
-Read `references/source-index.md` as a path-hint index whenever the task depends on exact modules, annotations, auto configuration, properties, controllers, clients, repositories, DTOs, handlers, or troubleshooting.
-
-## Workflow
-
-1. Identify whether the task targets the unified scheduler API, a concrete scheduler backend, generated SDK client calls, workflow/task/resource APIs, cron/schedule behavior, or execution/log troubleshooting.
-2. Read `references/source-index.md`, then start from the unified API module before touching a backend adapter.
-3. Prefer `SchedulerFacadeApi` as the application-facing entry point; it combines execution commands, cron commands, executor operations, and query operations.
-4. For execution behavior, inspect `SchedulerExecutor`; for query/log/history behavior, inspect `SchedulerQuery`; for schedule expression behavior, inspect `SchedulerCronCommand` and `SchedulerCron`.
-5. Choose the concrete backend adapter only after the target scheduler is known: DM Scheduler, DolphinScheduler, XXL-JOB, or ElasticJob.
-6. For raw REST/API interactions, inspect the generated SDK module matching the backend (`dm-scheduler-sdk`, `dolphinscheduler-sdk`, `xxljob-sdk`) and its `ApiClient`/server configuration.
-7. Keep backend-specific models isolated behind the anti-corrosion API unless the task is explicitly adapter development.
-
-## Capability Split
-
-- Unified API: `yss-component-anti-scheduler-api`, especially `SchedulerFacadeApi`, `SchedulerExecutor`, `SchedulerQuery`, `SchedulerCronCommand`, and `SchedulerFactory`.
-- DM Scheduler adapter: `yss-component-anti-scheduler-dmscheduler` plus `dm-scheduler-sdk`.
-- DolphinScheduler adapter: `yss-component-anti-scheduler-dolphin` plus `dolphinscheduler-sdk`.
-- XXL-JOB adapter: `yss-component-anti-scheduler-xxljob` plus `xxljob-sdk`.
-- ElasticJob adapter: `yss-component-anti-scheduler-elasticjob`.
-- Cross-domain APIs: task flow, task definition/instance, workflow execution, resource/file, tenant/user, datasource, quality, tag, variable, and log APIs in generated clients.
-
-## Checklist
-
-- Required dependency or scheduler adapter module is present.
-- Target scheduler backend is identified before using backend-specific APIs.
-- Scheduler host/token/auth/server configuration is externalized.
-- Task group, task instance, cron, and log identifiers use the component domain model consistently.
-- `stop`, `taskInstance`, subtask, and other default methods may be unsupported by some backends; check implementation before relying on them.
-- Backend-specific DTOs do not leak into business modules unless the adapter boundary is the task.
-- Execution/log/retry operations are checked against scheduler permissions and environment.
-
-## Do Not
-
-- Do not invent class names or configuration keys without checking the source index.
-- Do not replace component extension points with business-local framework code.
-- Do not broaden the task into unrelated YSS components unless the user asks.

package/template/.codex/skills/yss-anti-scheduler/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "yss-anti-scheduler"
-  short_description: "YSS component skill for yss-anti-scheduler"
-  default_prompt: "Use yss-anti-scheduler for this YSS backend component task."