create-yss-spec 1.0.0

package/template/docs/process/templates/daily-standup-template.md

@@ -0,0 +1,46 @@
+# Daily Standup 摘要
+
+> **日期:** YYYY-MM-DD | **Sprint N Day X** | 自动生成
+
+---
+
+## 团队进度总览
+
+| 指标 | 数值 |
+|------|------|
+| Sprint 进度 | X/Y SP (XX%) |
+| 剩余天数 | X 天 |
+| 预计完成 | {趋势: On Track / At Risk / Off Track} |
+
+---
+
+## 个人摘要
+
+> 以下由 AI 从 Git commits / PR 状态 / Slack 自动汇总
+
+### 张三
+- **昨日完成:** {从 Git log 提取}
+- **今日计划:** {从 Sprint Backlog 推断}
+- **阻塞项:** 无
+
+### 李四
+- **昨日完成:**
+- **今日计划:**
+- **阻塞项:** ⚠️ {自动检测到未关闭的 issue}
+
+---
+
+## 阻塞项汇总
+
+| 阻塞项 | 影响人 | 持续时间 | 需要帮助 |
+|--------|--------|---------|---------|
+| | | | |
+
+---
+
+## 风险预警
+
+> AI 自动检测：
+
+- ⚠️ Sprint 进度落后预期 15%，建议关注
+- ⚠️ Bug 数量本周增长 30%，集中在订单模块

package/template/docs/process/templates/sprint-planning-template.md

@@ -0,0 +1,59 @@
+# Sprint Planning 模板
+
+> **Sprint N** | 日期: YYYY-MM-DD → YYYY-MM-DD | 时长: 2 周
+
+---
+
+## Sprint Goal
+
+{一句话描述本 Sprint 的核心目标}
+
+---
+
+## 容量规划
+
+| 成员 | 可用人天 | 备注 |
+|------|---------|------|
+| | | |
+
+**团队总容量:** XX 人天 | **目标 Velocity:** XX SP
+
+---
+
+## Sprint Backlog
+
+| ID | Story | 优先级 | SP | 负责人 | 验收条件 | AI 风险 |
+|----|-------|--------|-----|--------|---------|---------|
+| S-001 | {用户故事} | P0 | | | Given/When/Then | 🟢/🟡/🔴 |
+
+---
+
+## AI 辅助拆解 (Plan Agent)
+
+### S-001: {Story 标题}
+
+**子任务：**
+- [ ] 后端: {具体任务} → Xd
+- [ ] 前端: {具体任务} → Xd
+- [ ] 测试: {具体任务} → Xd
+
+**潜在风险:** {AI 标注}
+
+---
+
+## 风险登记
+
+| 风险 | 概率 | 影响 | 缓解 | Owner |
+|------|------|------|------|-------|
+| | | | | |
+
+---
+
+## Definition of Done
+
+- [ ] 代码通过 Review (Agent + 人工)
+- [ ] 测试覆盖率 ≥ 80%
+- [ ] 集成测试通过
+- [ ] API 文档已更新
+- [ ] 无安全高危告警
+- [ ] 项目质量门禁通过

package/template/docs/process/templates/sprint-retro-template.md

@@ -0,0 +1,113 @@
+# Sprint Retrospective 报告
+
+> **Sprint N** | 日期: YYYY-MM-DD | 自动生成时间: {timestamp}
+
+---
+
+## Sprint 数据摘要
+
+> 以下数据由 AI 自动采集和分析
+
+| 指标 | 数值 | 上 Sprint | 趋势 |
+|------|------|----------|------|
+| Velocity | XX SP | XX SP | ↑/↓/→ |
+| Cycle Time (P50) | Xh | Xh | ↑/↓/→ |
+| Cycle Time (P90) | Xh | Xh | ↑/↓/→ |
+| Code Churn Rate | XX% | XX% | ↑/↓/→ |
+| Bug/SP Rate | X.X | X.X | ↑/↓/→ |
+| AI 采纳率 | XX% | XX% | ↑/↓/→ |
+
+---
+
+## AI 分析报告
+
+### 流程瓶颈
+
+> AI 自动识别：
+
+- **瓶颈 1:** {描述 + 数据证据}
+- **建议:** {改进措施}
+
+### 质量热点
+
+- **热点模块:** {模块名} — Bug 密度最高
+- **建议:** 增加单元测试覆盖，考虑重构
+
+### 团队节奏
+
+- 本周期的 Code Review 平均等待时间: Xh
+- 建议: {如果等待时间过长，建议增加 Review Agent 使用频率}
+
+---
+
+## Start / Stop / Continue
+
+> 团队讨论区域。AI 提供数据支撑，团队决策。
+
+### Start (开始做)
+
+| 事项 | 提出人 | 原因 |
+|------|--------|------|
+| | | |
+
+### Stop (停止做)
+
+| 事项 | 提出人 | 原因 |
+|------|--------|------|
+| | | |
+
+### Continue (继续做)
+
+| 事项 | 提出人 | 原因 |
+|------|--------|------|
+| | | |
+
+---
+
+## Action Items
+
+| ID | 改进项 | 类型 | Owner | Due | 状态 |
+|----|--------|------|-------|-----|------|
+| AI-001 | {改进描述} | 流程/工具/规范 | @某人 | Sprint N+1 | ⏳ |
+| AI-002 | | | | | |
+
+---
+
+## 知识沉淀
+
+> 以下由 AI 自动识别应该写入 AGENTS.md / Skills 的条目：
+
+### 建议写入 AGENTS.md
+
+```markdown
+### 业务规则
+- {本次 Sprint 发现的新规则}
+
+### 已知陷阱  
+- {本次 Sprint 踩过的坑}
+```
+
+### 建议创建/更新 Skill
+
+| Skill 名 | 内容摘要 | 理由 |
+|----------|---------|------|
+| | | |
+
+---
+
+## 团队满意度
+
+| 维度 | 评分 (1-5) | 备注 |
+|------|-----------|------|
+| 开发体验 | | |
+| 工具链效率 | | |
+| AI 辅助效果 | | |
+| 团队协作 | | |
+
+---
+
+## 下次 Retro 检查
+
+| 上期 Action Item | 状态 | 效果评估 |
+|-----------------|------|---------|
+| | ✅ 完成 / ⚠️ 部分 / ❌ 未完成 | |

package/template/docs/process/templates/sprint-review-template.md

@@ -0,0 +1,53 @@
+# Sprint Review 报告
+
+> **Sprint N** | 日期: YYYY-MM-DD
+
+---
+
+## Sprint Goal 达成
+
+**目标:** {Sprint Goal}
+**达成:** ✅ / ⚠️ / ❌
+
+---
+
+## 完成情况
+
+| 指标 | 计划 | 实际 | 达成率 |
+|------|------|------|--------|
+| Story Points | | | |
+| Stories 完成 | | | |
+| 测试通过率 | | | |
+
+---
+
+## 已完成 Story
+
+| Story | 负责人 | 测试数 | 备注 |
+|-------|--------|--------|------|
+| | | | |
+
+---
+
+## 质量仪表板
+
+| 指标 | 数值 | 趋势 | 阈值 |
+|------|------|------|------|
+| 测试覆盖率 | % | ↑/↓ | ≥80% |
+| Bug 数 | | | |
+| AI 采纳率 | % | | |
+| Cycle Time | h | | |
+
+---
+
+## 未完成项
+
+| Story | 原因 | 处理 |
+|-------|------|------|
+
+---
+
+## 干系人反馈
+
+| 来源 | 内容 | 处理 |
+|------|------|------|

package/template/docs/process/templates/stage-checkpoint-template.md

@@ -0,0 +1,66 @@
+---
+status: template
+owner: ai
+---
+
+# 阶段 Checkpoint 记录模板
+
+> 用于每个生命周期阶段结束时，复制到 Issue 评论、MR / PR 描述或阶段文档。目标是固定产物、验证、风险、Issue 同步和 Git checkpoint 判断，避免阶段结论只停留在本地上下文。
+
+## 基本信息
+
+| 字段 | 内容 |
+|---|---|
+| Feature / Change |  |
+| 当前阶段 |  |
+| 对应门禁 |  |
+| 记录日期 |  |
+| 记录人 / Agent |  |
+| Issue / MR / PR |  |
+
+## 阶段产物
+
+| 产物 | 路径 / 链接 | 状态 | 备注 |
+|---|---|---|---|
+|  |  | `done` / `draft` / `not-applicable` |  |
+
+## Issue 同步状态
+
+| 项目 | 内容 |
+|---|---|
+| Issue tracker | GitLab / GitHub / 本地文档 |
+| 已同步内容 |  |
+| 未同步原因 |  |
+| 下一次同步点 |  |
+
+## 验证证据
+
+| 验证项 | 命令 / 方式 | 结果 | 证据 |
+|---|---|---|---|
+|  |  | `pass` / `fail` / `not-run` |  |
+
+## 阻塞项与安全人审
+
+| 类型 | 描述 | 处理方式 | 是否阻断 |
+|---|---|---|---|
+| 阻塞项 |  |  | 是 / 否 |
+| 安全红线 |  | `TODO-HUMAN-REVIEW` / 不适用 | 是 / 否 |
+| 架构漂移 |  | Architecture Re-check / 不适用 | 是 / 否 |
+
+## Git Checkpoint 判断
+
+| 项目 | 内容 |
+|---|---|
+| 本阶段应纳入提交的路径 |  |
+| 明确排除的无关脏文件 |  |
+| 建议动作 | commit / 暂缓 / 需要人工确认 |
+| 暂缓原因 |  |
+| 推送建议 | push / 暂缓 / 不适用 |
+
+## 下一步
+
+- 下一阶段：
+- 进入条件：
+- 负责人：
+- 预计补齐项：
+

package/template/docs/releases/.gitkeep

@@ -0,0 +1 @@
+

package/template/docs/requirements/README.md

@@ -0,0 +1,83 @@
+# 需求定义 (Requirements) — 从想法到可执行定义
+
+> **Phase: Requirements | 输入: Discovery | 输出: PRD + Stories + 验收条件**
+
+---
+
+## Engineering Skills 流程
+
+默认需求链路：
+
+```text
+grill-with-docs -> to-prd -> API 影响分析 / 契约草案 -> Architecture 反审 -> OpenAPI Freeze -> to-issues
+```
+
+进入开发前必须满足：
+
+- [ ] PRD 使用 [../templates/prd-template.md](../templates/prd-template.md)。
+- [ ] OpenAPI 影响明确为“无”或已产出契约草案 / review-only Draft；进入开发前必须冻结 `docs/api/specs/*.yaml`。
+- [ ] 测试决策明确主要测试 seam。
+- [ ] AI / 人工审查点标注安全红线。
+- [ ] 后续 Issue 使用 [../templates/vertical-slice-issue-template.md](../templates/vertical-slice-issue-template.md)，不得按层横向拆分。
+
+## AI 三步法
+
+### Step 1: 生成 PRD 初稿
+
+```python
+delegate_task(
+    goal="根据发现报告生成 PRD 初稿",
+    context="""
+    输入：发现报告 (市场+竞品+用户)
+    输出：背景/用户画像/场景/功能需求/NFR/验收条件/边界/技术影响
+    """
+)
+```
+
+### Step 2: 补充边界场景
+
+```python
+delegate_task(
+    goal="对 PRD 做边界场景挖掘",
+    context="""
+    从以下角度挖掘遗漏场景：
+    空值/并发/权限/网络异常/数据量极端/时间相关/国际化
+    """
+)
+```
+
+### Step 3: 拆解用户故事
+
+```python
+delegate_task(
+    goal="将 PRD 拆解为可估算的用户故事",
+    context="""
+    格式: As a / I want / So that
+    附带 Gherkin 验收条件 + 优先级(P0/P1/P2) + AI风险标注
+    """
+)
+```
+
+---
+
+## PRD 模板结构
+
+1. 问题陈述 / 解决方案
+2. 用户故事
+3. 功能需求 / 非功能需求
+4. 验收标准
+5. OpenAPI 影响
+6. 测试决策
+7. AI / 人工审查点
+8. 非目标范围
+9. 风险
+
+---
+
+## AI-Human Loop
+
+```
+Discovery报告 → AI生成PRD → PM审核
+→ AI补充边界 → PM确认 → AI拆解Stories
+→ 团队估算 → AI标注风险 → TechLead确认 → 进入Architecture
+```

package/template/docs/requirements/issues/.gitkeep

@@ -0,0 +1 @@
+

package/template/docs/templates/agent-brief-template.md

@@ -0,0 +1,46 @@
+# Agent Brief：<Issue 标题>
+
+> 本简报用于 `ready-for-agent` 状态的 Issue。内容必须足够完整，使 Agent 无需向维护者询问隐藏背景即可开始工作。
+
+## Issue 信息
+
+- 链接：
+- 分类：bug / enhancement
+- 状态：ready-for-agent
+
+## 背景
+
+记录已知信息，包括 `CONTEXT.md` 中的相关领域术语，以及约束方案的 ADR。
+
+## 目标
+
+Agent 必须交付的可观察行为。
+
+## 非目标
+
+Agent 不应修改的范围。
+
+## 验收标准
+
+- [ ] 标准 1
+- [ ] 标准 2
+- [ ] 标准 3
+
+## 实现提示
+
+- 推荐测试 seam：
+- OpenAPI Draft / Freeze 影响：
+- 相关既有实现：
+
+## 验证方式
+
+Agent 应运行的命令或检查：
+
+```bash
+# 命令
+```
+
+## 安全与人工审查
+
+- [ ] 未触碰安全红线
+- [ ] 涉及支付、迁移、认证、原生 SQL 或公共基础库 API 时，必须包含 `TODO-HUMAN-REVIEW`

package/template/docs/templates/architecture-proposal-template.md

@@ -0,0 +1,18 @@
+---
+pipeline: <feature-id>
+stage: design
+status: draft
+owner: ai
+---
+
+# 架构方案：<功能名称>
+
+## 背景
+
+## 备选方案
+
+## 决策
+
+## 风险
+
+## 验证方式

package/template/docs/templates/build-architecture-checklist-template.md

@@ -0,0 +1,69 @@
+---
+status: template
+owner: ai
+---
+
+# <功能 / change> Build Architecture Checklist
+
+> 本模板用于 垂直切片实现 前和每个垂直切片完成后，把系统架构、数据架构、ADR、工程基线、OpenAPI Freeze 结论和安全红线转译为可执行检查项。它不是替代架构文档，而是防止架构资产在 build 阶段失效。
+
+## 1. 输入资产
+
+| 资产 | 路径 | 状态 |
+|---|---|---|
+| 系统架构 |  |  |
+| 数据架构 |  |  |
+| ADR |  |  |
+| 工程基线 |  |  |
+| OpenAPI Freeze |  |  |
+| 系统 / 数据架构设计 |  |  |
+| 安全红线 | `AGENTS.md` |  |
+
+## 2. 架构约束矩阵
+
+| constraint | source | slice | status | evidence | follow-up |
+|---|---|---|---|---|---|
+| DDD 分层不得穿透：Domain 不依赖 Adapter、Infrastructure、Mapper、Controller 或 Web DTO | 系统架构 / YSS DDD 规范 / `AGENTS.md` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 若发现穿透依赖，标记 `violation` 并停止 build，回到架构修正 |
+| 安全红线：认证 / 授权、SQL / DDL、迁移、加密、公共基础库 API 变更必须 `TODO-HUMAN-REVIEW` | `AGENTS.md` |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  | 未有人审证据时不得发布或合并 |
+|  |  |  | `implemented` / `seam-deferred` / `drift` / `violation` / `not-applicable` |  |  |
+
+状态说明：
+
+- `implemented`：已有代码、测试或文档证据证明满足约束。
+- `seam-deferred`：允许临时 seam，但必须说明风险、补齐切片和 `TODO-HUMAN-REVIEW`；安全红线不得无限延期。
+- `drift`：实现与架构意图不一致，必须先做 Architecture Re-check。
+- `violation`：违反架构或安全红线，停止继续 build，回到设计审查或架构修正。
+- `not-applicable`：当前切片不触碰该约束，并说明原因。
+
+字段说明：
+
+- `source`：回指系统架构、数据架构、ADR、OpenAPI Freeze、工程基线或安全红线来源。
+- `constraint`：可检查的架构或治理约束。
+- `slice`：绑定的垂直切片编号或名称。
+- `status`：只能使用上方状态枚举。
+- `evidence`：代码、测试、文档、Issue 评论或人审证据。
+- `follow-up`：延期、漂移或违反时的补齐落点和是否阻断继续 build。
+
+## 3. 当前切片回勾
+
+| 切片 | 已落实 | seam / 延期 | 漂移 | 违反 | 是否允许继续 |
+|---|---|---|---|---|---|
+|  |  |  |  |  |  |
+
+## 4. 人工审查点
+
+| 红线 | 是否触碰 | TODO-HUMAN-REVIEW | 人审证据 | 阻断结论 |
+|---|---|---|---|---|
+| SQL / DDL |  |  |  |  |
+| 数据库迁移 |  |  |  |  |
+| 认证 / 授权 |  |  |  |  |
+| 审计日志 |  |  |  |  |
+| 文件上传下载 / 临时 URL |  |  |  |  |
+| 加密算法 |  |  |  |  |
+
+## 5. 结论
+
+- 是否允许继续 build：
+- 必须先修正：
+- 可延期到后续切片：
+- fresh verification 命令：

package/template/docs/templates/cross-repo-slice-template.md

@@ -0,0 +1,81 @@
+---
+pipeline: <feature-id>
+stage: cross-repo-slice
+status: draft
+owner: ai
+---
+
+# <切片名称>跨仓库垂直切片记录
+
+> 用于绑定一个 Harness change 下的前端、后端、契约、验证和发布证据。没有影响的实现仓库必须标记 `not-applicable`，不能留空。
+
+## 1. Harness 绑定
+
+| 字段 | 值 |
+|---|---|
+| harness_change |  |
+| slice_id |  |
+| vertical_slice_issue |  |
+| implementation_routing |  |
+| build_architecture_checklist |  |
+
+## 2. Contract 绑定
+
+| 字段 | 值 |
+|---|---|
+| openapi_spec |  |
+| freeze_record |  |
+| generated_client |  |
+| contract_verification |  |
+
+## 3. Backend
+
+| 字段 | 值 |
+|---|---|
+| backend_repo |  |
+| backend_branch |  |
+| backend_mr_pr |  |
+| backend_ci |  |
+| backend_verification |  |
+| backend_status | pending / ready / blocked / not-applicable |
+
+## 4. Frontend
+
+| 字段 | 值 |
+|---|---|
+| frontend_repo |  |
+| frontend_branch |  |
+| frontend_mr_pr |  |
+| frontend_ci |  |
+| frontend_verification |  |
+| frontend_status | pending / ready / blocked / not-applicable |
+
+## 5. Fresh Verification
+
+| 字段 | 值 |
+|---|---|
+| fresh_verification |  |
+
+| 验证项 | 命令 / 证据 | 结果 |
+|---|---|---|
+| Contract |  | pass / fail / not-applicable |
+| Backend |  | pass / fail / not-applicable |
+| Frontend |  | pass / fail / not-applicable |
+| E2E / 关键路径 |  | pass / fail / not-applicable |
+
+## 6. Release And Rollback
+
+| 字段 | 值 |
+|---|---|
+| release_and_rollback |  |
+| release_note |  |
+| rollout_record |  |
+| rollback_point |  |
+| observe_signal |  |
+| human_review |  |
+
+## 7. 结论
+
+- 是否允许进入 review / merge：
+- 阻断项：
+- 下一步：

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

@@ -0,0 +1,16 @@
+---
+pipeline: <feature-id>
+stage: design
+status: draft
+owner: ai
+---
+
+# 实现计划：<功能名称>
+
+## 目标
+
+## 任务拆解
+
+## 完成定义
+
+## 验证方式