create-yss-spec 1.0.0

package/template/docs/templates/implementation-repo-registry-template.md

@@ -0,0 +1,64 @@
+---
+pipeline: <feature-id>
+stage: implementation-repo-registry
+status: draft
+owner: ai
+---
+
+# <仓库名称>实现仓库登记
+
+> 用于把外部前端、后端或其他运行时代码仓库接入当前 Harness / 研发管理仓库。本文不替代实现仓库 README、CI 配置或 MR / PR。
+
+## 1. 基本信息
+
+| 字段 | 值 |
+|---|---|
+| repo_role | backend / frontend / fullstack / other |
+| git_url |  |
+| default_branch |  |
+| local_worktree |  |
+| scaffold_status | existing / required / initialized |
+| scaffold_skill | `yss-ddd-scaffold-generator` / `yss-frontend-scaffold-generator` / none |
+| owner |  |
+| ci_system | GitLab CI / GitHub Actions / Jenkins / other / none |
+| issue_tracker | GitLab / GitHub / other |
+
+## 2. 命令与流水线
+
+| 类型 | 命令 / 链接 | 说明 |
+|---|---|---|
+| install_command |  |  |
+| test_command |  |  |
+| build_command |  |  |
+| lint_command |  |  |
+| typecheck_command |  |  |
+| ci_pipeline |  |  |
+
+## 3. 契约与设计接入
+
+| 接入项 | 状态 | 证据 / 路径 | 缺口 |
+|---|---|---|---|
+| openapi_integration | 已接入 / 部分接入 / 未接入 / 不适用 |  |  |
+| design_token_integration | 已接入 / 部分接入 / 未接入 / 不适用 |  |  |
+| generated_client | 已接入 / 部分接入 / 未接入 / 不适用 |  |  |
+| yss_ui_baseline | 已接入 / 部分接入 / 未接入 / 不适用 |  |  |
+| yss_backend_baseline | 已接入 / 部分接入 / 未接入 / 不适用 |  |  |
+
+## 4. 已知偏离项
+
+| known_gaps | 风险 | 补齐计划 | 是否阻断 |
+|---|---|---|---|
+|  |  |  | 是 / 否 |
+
+## 5. 人工审查
+
+| human_review_required | 原因 | 审查人 / 角色 | 结论 |
+|---|---|---|---|
+| 是 / 否 |  |  |  |
+
+## 6. Harness 回写
+
+- 关联 Harness change：
+- 关联垂直切片：
+- 关联阶段 checkpoint：
+- fresh verification 命令：

package/template/docs/templates/implementation-routing-template.md

@@ -0,0 +1,95 @@
+---
+pipeline: <feature-id>
+stage: implementation-routing
+status: draft
+owner: ai
+---
+
+# <功能名称>实现路由记录
+
+> 适用场景：PRD、OpenAPI Freeze / 无 API 影响记录、Design Review 和垂直切片 Issue 已就绪后，进入实现前。
+> 本文记录契约状态、Issue 状态、YSS skill 最小集合、测试策略和回滚点，不替代垂直切片 Issue 或实施计划。
+
+## 1. 输入材料
+
+| 资产 | 路径 / 链接 | 状态 | 备注 |
+|------|-------------|------|------|
+| 垂直切片 Issue |  |  |  |
+| OpenAPI Freeze / 无 API 影响记录 |  |  |  |
+| OpenSpec-style Spec Delta（条件必需） |  |  | 仅 API、权限、状态机、数据模型、跨端、新模块或高风险变更需要 |
+| Design Review |  |  |  |
+| 实现仓库 / 实现位置 |  |  |  |
+| 前后端工程存在性判定 |  |  | 记录 frontend / backend 是否已存在且可复用 |
+| `垂直切片 Issue 状态` |  |  | ready / blocked / in-progress |
+
+## 2. 实现前门禁
+
+| 检查项 | 结果 | 备注 |
+|--------|------|------|
+| PRD 验收标准已可追溯 | 是 / 否 |  |
+| OpenAPI Freeze 或无 API 影响记录已完成 | 是 / 否 |  |
+| Spec Delta 已补齐或明确不需要 | 是 / 否 / 不适用 |  |
+| Design Review 阻断项已关闭 | 是 / 否 / 不适用 |  |
+| 垂直切片 Issue 已拆到端到端可验收 | 是 / 否 |  |
+| 实现仓库 / 实现位置已登记 | 是 / 否 |  |
+| 受影响 frontend 工程已存在可复用，或已完成初始化决策 | 是 / 否 / 不适用 |  |
+| 受影响 backend 工程已存在可复用，或已完成初始化决策 | 是 / 否 / 不适用 |  |
+| 缺失工程时已路由到对应脚手架 skill | 是 / 否 / 不适用 | `yss-ddd-scaffold-generator` / `yss-frontend-scaffold-generator` |
+| YSS skill 路由已完成 | 是 / 否 |  |
+| fresh verification 方式已明确 | 是 / 否 |  |
+
+## 3. YSS skill 最小集合
+
+| 领域 | skill | 使用原因 | 是否必需 |
+|------|-------|----------|----------|
+| 前端 |  |  | 是 / 否 |
+| 后端 |  |  | 是 / 否 |
+| API / 契约 |  |  | 是 / 否 |
+| 测试 / 验证 |  |  | 是 / 否 |
+
+## 4. 外部实现仓库
+
+| repo_role | git_url | default_branch | working_branch | MR / PR | CI | test_command | build_command | 状态 |
+|---|---|---|---|---|---|---|---|---|
+| backend |  |  |  |  |  |  |  | pending / ready / blocked / not-applicable |
+| frontend |  |  |  |  |  |  |  | pending / ready / blocked / not-applicable |
+| other |  |  |  |  |  |  |  | pending / ready / blocked / not-applicable |
+
+说明：当前仓库默认作为 Harness / 研发管理仓库；前后端实现默认位于外部实现仓库。缺少实现仓库登记时，先使用 `implementation-repo-onboarding`，并按 `docs/templates/implementation-repo-registry-template.md` 补齐登记。
+
+## 4.1 脚手架初始化判定
+
+| 受影响端 | 是否已有可用工程 | 处理结论 | 使用 skill | 输出位置 / 仓库 | 备注 |
+|---|---|---|---|---|---|
+| backend | 是 / 否 / 不适用 | 复用现有 / 初始化 / 阻塞 | `yss-ddd-scaffold-generator` / none |  |  |
+| frontend | 是 / 否 / 不适用 | 复用现有 / 初始化 / 阻塞 | `yss-frontend-scaffold-generator` / none |  |  |
+
+## 5. TDD 与验证策略
+
+| 层级 | 先失败测试 / 验证命令 | 通过标准 |
+|------|------------------------|----------|
+| Domain / Application |  |  |
+| API / 契约 |  |  |
+| 前端组件 |  |  |
+| E2E / 关键路径 |  |  |
+
+## 6. 回滚点与风险
+
+| 风险 | 回滚点 | 观察信号 | 负责人 |
+|------|--------|----------|--------|
+|  |  |  |  |
+
+## 7. 完成标准
+
+- [ ] 垂直切片 Issue 完整，且状态允许进入实现。
+- [ ] YSS skills 已最小化选择，没有绕过 Issue、OpenAPI Freeze / 无 API 影响记录或必要的 Spec Delta。
+- [ ] 受影响外部实现仓库已登记，并绑定分支、MR / PR、CI 和验证命令。
+- [ ] 受影响 frontend / backend 工程存在性已判定；缺失工程已完成脚手架初始化或明确阻塞原因。
+- [ ] 每个切片包含测试命令、验证方式和回滚点。
+- [ ] 触碰安全红线的项已标记 `TODO-HUMAN-REVIEW`。
+
+## 8. 下一步门禁
+
+- 结论：Approved / Blocked
+- 下一步：TDD 实现 / 回到 系统 / 数据架构设计 / 回到垂直切片
+- 阻断项：

package/template/docs/templates/openapi-spec-template.yaml

@@ -0,0 +1,11 @@
+---
+pipeline: <feature-id>
+stage: open
+status: draft
+owner: ai
+---
+openapi: 3.1.0
+info:
+  title: <功能 API>
+  version: 0.1.0
+paths: {}

package/template/docs/templates/prd-template.md

@@ -0,0 +1,93 @@
+---
+pipeline: <feature-id>
+stage: open
+status: draft
+owner: ai
+---
+
+# 产品需求文档：<功能名称>
+
+## 问题陈述
+
+（从用户视角描述要解决的问题。）
+
+## 解决方案
+
+（从用户视角描述解决方案。）
+
+## 用户故事
+
+1. 作为<角色>，我希望<能力>，以便<收益>。
+
+## 功能需求
+
+| ID | 需求 | 优先级 | 备注 |
+|---|---|---|---|
+| FR-001 | | P0/P1/P2 | |
+
+## 非功能需求
+
+| 类别 | 需求 | 目标 |
+|---|---|---|
+| 性能 | | |
+| 安全 | | |
+| 可靠性 | | |
+
+## 验收标准
+
+```gherkin
+假如 <上下文>
+当 <操作>
+那么 <可观察结果>
+```
+
+## OpenAPI 影响
+
+- [ ] 无
+- [ ] 需要 API 影响分析 / 契约草案
+- [ ] 需要 review-only OpenAPI Draft：`docs/api/specs/<feature>.yaml`
+
+> OpenAPI Draft 在 OpenAPI Freeze 前仅用于评审和架构反审，不作为实现或生成客户端的稳定契约。
+
+受影响端点：
+
+| 方法 | 路径 | 变更 |
+|---|---|---|
+| | | |
+
+## DDD 影响判断
+
+> 仅做轻量判断，不新增流程阶段。若均为“否”，后续不需要单独 DDD 设计；若触发边界、模型或一致性变化，在产品总体设计 / 系统概要设计中补齐对应小节。
+
+| 检查项 | 是 / 否 | 说明 / 处理 |
+|---|---|---|
+| 是否新增或改变统一语言 / 核心术语 |  | 需要回写 `CONTEXT.md` |
+| 是否新增或改变限界上下文 / 模块边界 |  | 需要在产品总体设计中完成 Strategic DDD Check |
+| 是否改变上下文间协作关系 |  | 说明上游 / 下游 / 防腐层 / 共享内核关系 |
+| 是否新增或改变聚合、不变量、状态机 |  | 需要在系统概要设计 / 数据架构中完成 Tactical DDD Check |
+| 是否影响 API、权限、数据、审计或安全红线 |  | 进入对应契约、架构或人工审查门禁 |
+
+## 测试决策
+
+- 主要测试 seam：
+- 代码库中的相似测试：
+- 必需测试：
+  - [ ] 单元 / 领域行为
+  - [ ] API / 契约
+  - [ ] 前端组件
+  - [ ] E2E 关键路径
+
+## AI / 人工审查点
+
+| 范围 | Agent 权限 | 是否需要人工审查 | 备注 |
+|---|---|---|---|
+| 支付逻辑 | 仅生成草案 | 是 | |
+| 数据库迁移 | 仅生成模板 | 是 | |
+| 认证 / 授权 | 仅生成草案 | 是 | |
+| 加密算法 | 禁止生成 | 是 | |
+| 原生 SQL | 仅生成草案 | 是 | |
+| 公共基础库 API | 仅生成草案 | 是 | |
+
+## 非目标范围
+
+## 风险

package/template/docs/templates/release-note-template.md

@@ -0,0 +1,14 @@
+---
+pipeline: <feature-id>
+stage: archive
+status: draft
+owner: ai
+---
+
+# 发布说明：<功能名称>
+
+## 变更内容
+
+## 迁移说明
+
+## 验证结果

package/template/docs/templates/requirement-freeze-template.md

@@ -0,0 +1,62 @@
+---
+pipeline: <feature-id>
+stage: requirement-freeze
+status: draft
+owner: ai
+---
+
+# <功能名称>需求冻结记录
+
+> 适用场景：PRD 初稿经过业务架构、功能架构、产品设计 / 原型评审后，需要冻结可进入 API 影响分析 / 契约草案和工程设计的范围。
+> 本文记录最终范围、回填项、非目标和开放问题，不替代 PRD。
+
+## 1. 输入材料
+
+| 资产 | 路径 / 链接 | 状态 | 备注 |
+|------|-------------|------|------|
+| PRD 初稿 |  |  |  |
+| 业务 / 功能架构 |  |  |  |
+| 产品设计 / 交互说明 |  |  |  |
+| Prototype Review |  |  |  |
+| CONTEXT 术语 |  |  |  |
+
+## 2. 冻结范围
+
+| 能力 | 是否冻结进入本轮 | 优先级 | 验收标准链接 / 摘要 |
+|------|------------------|--------|---------------------|
+|  | 是 / 否 | P0 / P1 / P2 |  |
+
+## 3. PRD 回填完成情况
+
+| 回填项 | 来源 | 处理结果 | 是否阻断 |
+|--------|------|----------|----------|
+|  | 产品设计 / 原型评审 / 架构 | 已回填 / 延后 / 拒绝 | 是 / 否 |
+
+## 4. 非目标与延后项
+
+| 项目 | 原因 | 后续触发条件 |
+|------|------|--------------|
+|  |  |  |
+
+## 5. OpenAPI 与架构影响
+
+| 影响类型 | 结论 | 下一步 |
+|----------|------|--------|
+| OpenAPI | 有 / 无 / 待确认 | API 影响分析 / 契约草案 / 无 API 影响记录 / 阻断 |
+| 工程基线 | 有 / 无 | 工程基线审查 / 跳过 |
+| 系统架构 | 有 / 无 | 系统概要设计 / 跳过 |
+| 数据架构 | 有 / 无 | 数据架构 / 跳过 |
+| 安全红线 | 有 / 无 | `TODO-HUMAN-REVIEW` / 跳过 |
+
+## 6. 完成标准
+
+- [ ] PRD 已吸收产品设计、原型评审和功能架构暴露的阻断项。
+- [ ] 本轮做什么、不做什么、延后什么已经明确。
+- [ ] OpenAPI、工程基线、系统架构、数据架构、安全红线影响已有明确结论。
+- [ ] 可进入 API 影响分析 / 契约草案 / 工程基线，或阻断项已列出。
+
+## 7. 下一步门禁
+
+- 结论：Approved / Blocked
+- 下一步：API 影响分析 / 契约草案 / 工程基线 / 回到 PRD 或产品设计
+- 阻断项：

package/template/docs/templates/retro-report-template.md

@@ -0,0 +1,16 @@
+---
+pipeline: <feature-id>
+stage: archive
+status: draft
+owner: ai
+---
+
+# 复盘报告：<功能名称>
+
+## 做得好的地方
+
+## 需要改进的地方
+
+## 改进动作
+
+## 沉淀去向

package/template/docs/templates/review-report-template.md

@@ -0,0 +1,16 @@
+---
+pipeline: <feature-id>
+stage: verify
+status: draft
+owner: ai
+---
+
+# 审查报告：<功能名称>
+
+## 结论
+
+## 发现
+
+## 必须修复项
+
+## 签字确认

package/template/docs/templates/risk-register-template.md

@@ -0,0 +1,11 @@
+---
+pipeline: <feature-id>
+stage: design
+status: draft
+owner: ai
+---
+
+# 风险登记表：<功能名称>
+
+| 风险 | 影响 | 可能性 | 应对措施 | 负责人 |
+|------|--------|------------|------------|-------|

package/template/docs/templates/spec-delta-template.md

@@ -0,0 +1,69 @@
+# <功能名称> Spec Delta
+
+> 适用场景：API、权限、状态机、数据模型、跨端协作、新模块或高风险变更需要在 PRD、OpenAPI Draft、Design Review 和垂直切片之间明确行为差异时使用。  
+> 本模板只借鉴 OpenSpec 的行为差异表达方式，不引入 OpenSpec CLI、旧式变更目录、变更状态文件或额外状态机。
+
+## 1. 变更摘要
+
+| 项 | 内容 |
+|---|---|
+| 需求 / PRD |  |
+| 相关 OpenAPI Draft / Freeze |  |
+| 相关架构 / 设计审查 |  |
+| 相关 Issue / 切片 |  |
+| 变更类型 | 新增 / 修改 / 移除 / 高风险修正 |
+| 是否阻塞实现 | 是 / 否 |
+
+## 2. 行为差异
+
+| 类型 | 行为 | 当前状态 | 目标状态 | 影响范围 |
+|---|---|---|---|---|
+| ADDED |  |  |  |  |
+| MODIFIED |  |  |  |  |
+| REMOVED |  |  |  |  |
+
+说明：
+
+- `ADDED`：新增用户可见行为、API 行为、状态、权限或数据约束。
+- `MODIFIED`：已有行为的输入、输出、状态流、权限、错误结构、兼容性或验收标准发生变化。
+- `REMOVED`：删除或废弃已有行为、字段、入口、权限、状态或兼容路径。
+
+## 3. 受影响范围
+
+| 维度 | 是否影响 | 说明 / 证据 |
+|---|---|---|
+| UI / 页面 / 交互状态 | 是 / 否 |  |
+| API / OpenAPI schema / 错误结构 | 是 / 否 |  |
+| 权限 / 认证 / 授权 | 是 / 否 |  |
+| 状态机 / 业务流程 | 是 / 否 |  |
+| 数据模型 / Repository / 查询索引 | 是 / 否 |  |
+| 外部系统 / 跨端协作 | 是 / 否 |  |
+| 发布 / 回滚 / 运维 | 是 / 否 |  |
+| 安全红线 / 人审点 | 是 / 否 |  |
+
+## 4. 验收场景
+
+| 场景 ID | 关联行为 | 前置条件 | 操作 | 期望结果 | 异常 / 边界 |
+|---|---|---|---|---|---|
+| SD-001 |  |  |  |  |  |
+| SD-002 |  |  |  |  |  |
+
+## 5. 测试与 fresh verification 映射
+
+| 场景 ID | 测试层级 | 测试 / 验证命令 | 证据路径 | 状态 |
+|---|---|---|---|---|
+| SD-001 | 单元 / 契约 / E2E / 手工验证 |  |  | planned / passed / blocked |
+| SD-002 | 单元 / 契约 / E2E / 手工验证 |  |  | planned / passed / blocked |
+
+## 6. 未决问题与人审点
+
+| 问题 / 风险 | 负责人 | 阻塞级别 | 处理方式 |
+|---|---|---|---|
+|  |  | blocking / non-blocking |  |
+
+## 7. 结论
+
+- 是否允许进入 OpenAPI Freeze / no API impact 记录：
+- 是否允许进入 `to-issues`：
+- 必须带入垂直切片的约束：
+- Git checkpoint 状态：

package/template/docs/templates/user-story-template.md

@@ -0,0 +1,20 @@
+---
+pipeline: <feature-id>
+stage: open
+status: draft
+owner: ai
+---
+
+# 用户故事：<功能名称>
+
+## 故事
+
+作为<用户>，我希望<能力>，以便<业务结果>。
+
+## 验收标准
+
+```gherkin
+假如 <上下文>
+当 <操作>
+那么 <结果>
+```

package/template/docs/templates/verification-record-template.md

@@ -0,0 +1,53 @@
+---
+pipeline: <feature-id>
+stage: verify
+status: draft
+owner: ai
+---
+
+# <功能名称>Fresh Verification 记录
+
+> 适用场景：合并、发布、归档或宣称完成前。
+> 本文记录最新验证证据；没有 fresh verification，不得给出“完成 / 可合并 / 可发布”结论。
+
+## 1. 验证范围
+
+| 范围 | 说明 | 是否覆盖 |
+|------|------|----------|
+| PRD 验收标准 |  | 是 / 否 |
+| OpenAPI / 契约 |  | 是 / 否 / 不适用 |
+| 后端行为 |  | 是 / 否 / 不适用 |
+| 前端组件 / 页面 |  | 是 / 否 / 不适用 |
+| E2E 关键路径 |  | 是 / 否 / 不适用 |
+| 安全红线 |  | 是 / 否 / 不适用 |
+
+## 2. 命令与结果
+
+| 时间 | 命令 | 结果 | 备注 |
+|------|------|------|------|
+|  |  | pass / fail / skipped |  |
+
+## 3. 手工验证
+
+| 场景 | 步骤 | 结果 | 证据 |
+|------|------|------|------|
+|  |  |  |  |
+
+## 4. 未覆盖风险
+
+| 风险 | 原因 | 处理方式 |
+|------|------|----------|
+|  |  |  |
+
+## 5. 完成标准
+
+- [ ] 验证命令是本次完成前新鲜执行的结果。
+- [ ] 失败项已有修复或明确阻断。
+- [ ] skipped 项有合理原因和后续处理方式。
+- [ ] 发布 / 合并 / 归档所需证据已能追溯。
+
+## 6. 结论
+
+- 验证结论：Approved / Blocked
+- 可合并 / 可发布：是 / 否
+- 阻断项：

package/template/docs/templates/vertical-slice-issue-template.md

@@ -0,0 +1,61 @@
+# 垂直切片 Issue：<标题>
+
+## 父级
+
+<PRD / 父级 issue 链接>
+
+## 要构建什么
+
+描述本 Issue 要交付的窄而完整的端到端行为。它必须贯穿所有受影响层，是可独立验证的垂直切片，不能只是某一层的横向任务。
+
+## 覆盖的用户故事
+
+- <用户故事 ID 或文本>
+
+## OpenAPI 影响
+
+- [ ] 无
+- [ ] 基于冻结 OpenAPI：`docs/api/specs/<feature>.yaml`
+
+受影响端点：
+
+| 方法 | 路径 | 变更 |
+|---|---|---|
+| | | |
+
+## 验收标准
+
+- [ ] 标准 1
+- [ ] 标准 2
+- [ ] 标准 3
+
+## 测试 Seam
+
+- 主要公共接口：
+- 必需测试：
+  - [ ] 行为 / 领域测试
+  - [ ] API / 契约测试
+  - [ ] UI / 组件测试
+  - [ ] E2E 测试
+
+## 阻塞关系
+
+- 无，可立即开始
+
+## AI / 人工审查点
+
+- [ ] 未触碰安全红线
+- [ ] 支付逻辑：`TODO-HUMAN-REVIEW`
+- [ ] 数据库迁移：`TODO-HUMAN-REVIEW`
+- [ ] 认证 / 授权：`TODO-HUMAN-REVIEW`
+- [ ] 加密算法：禁止实现
+- [ ] 原生 SQL：仅生成草案
+- [ ] 公共基础库 API：仅生成草案
+
+## 完成定义
+
+- [ ] 如有需要，已基于冻结 OpenAPI Spec 拆分切片
+- [ ] 实现完成
+- [ ] 已新增测试且测试通过
+- [ ] 已移除调试 / 原型代码
+- [ ] 如领域或架构决策变化，已更新 `CONTEXT.md` / ADR