newbee-sdd 1.0.0

package/scripts/newbee-sdd-check.ps1

@@ -0,0 +1,242 @@
+#Requires -Version 5.1
+<#
+.SYNOPSIS
+  newbee-sdd 机器检查脚本 v1.0（scheme: newbee-sdd v1）
+.DESCRIPTION
+  模式：detect（方案地图）/ resolve（工件根）/ check（单项目覆盖+模糊词）/ verify（多项目对账）/ migrate（scheme 行迁移辅助）。
+  编码：UTF-8 读写，CRLF/LF 均容忍。路径不硬编码用户名。
+.NOTES
+  机器算数字，模型做语义判断。覆盖率以本脚本输出为准。
+#>
+[CmdletBinding()]
+param(
+  [Parameter(Mandatory = $true, Position = 0)]
+  [ValidateSet('detect', 'resolve', 'check', 'verify', 'migrate')]
+  [string]$Mode,
+
+  [string[]]$ProjectRoots,      # verify 用（多个）；其他模式可用 -ProjectRoot
+  [string]$ProjectRoot,         # detect/resolve/check/migrate 用（单个）
+
+  [string[]]$VagueWords,        # 额外模糊词（来自 CONVENTIONS extra-vague-words）
+  [string]$FromScheme = 'v1',
+  [string]$ToScheme,            # 例：v2
+  [switch]$Quiet
+)
+
+$ErrorActionPreference = 'Stop'
+$OutputEncoding = [Console]::OutputEncoding = [Text.UTF8Encoding]::new($false)
+
+# ---------- 通用 ----------
+$DefaultVagueWords = @('快速', '适当地', '必要时', '尽量', '合理地', 'ASAP', '尽快', '等等', '及时', '高效')
+
+function Read-Text([string]$Path) {
+  if (-not (Test-Path -LiteralPath $Path)) { return $null }
+  return [IO.File]::ReadAllText($Path, [Text.UTF8Encoding]::new($false))
+}
+
+function Get-Scheme([string]$Path) {
+  $t = Read-Text $Path
+  if ($null -eq $t) { return $null }
+  $m = [regex]::Match($t, 'scheme:\s*newbee-sdd\s*(v[\w\.\-]+)')
+  if ($m.Success) { return $m.Groups[1].Value }
+  return $null
+}
+
+function Resolve-SpecsRoot([string]$Root) {
+  # 优先链：.newbee-specs-path（绝对路径，fail-loud）→ <root>\newbee-specs\
+  $decl = Join-Path $Root '.newbee-specs-path'
+  if (Test-Path -LiteralPath $decl) {
+    $p = (Read-Text $decl).Trim()
+    if (-not $p) { throw "FAIL-LOUD: $decl 存在但为空。按契约报错停下，不回落默认位置。" }
+    if (-not [IO.Path]::IsPathRooted($p)) { throw "FAIL-LOUD: $decl 必须是绝对路径，当前值：$p" }
+    if (-not (Test-Path -LiteralPath $p -PathType Container)) { throw "FAIL-LOUD: $decl 指向不存在的目录：$p。按契约报错停下，不回落默认位置。" }
+    return [pscustomobject]@{ Root = (Resolve-Path -LiteralPath $p).Path; Via = 'override'; Decl = $decl }
+  }
+  return [pscustomobject]@{ Root = (Join-Path $Root 'newbee-specs'); Via = 'default'; Decl = $null }
+}
+
+function Get-FeatureDirs([string]$SpecsRoot) {
+  if (-not (Test-Path -LiteralPath $SpecsRoot)) { return @() }
+  return Get-ChildItem -LiteralPath $SpecsRoot -Directory |
+    Where-Object { $_.Name -match '^\d{3}-' }
+}
+
+$script:Issues = New-Object System.Collections.Generic.List[string]
+function Add-Issue([string]$Severity, [string]$Message) {
+  $script:Issues.Add("[$Severity] $Message")
+}
+
+# ---------- detect ----------
+function Invoke-Detect([string]$Root) {
+  Write-Output "== 方案地图：$Root"
+  $markers = @(
+    @{ n = 'newbee（本方案）'; p = 'newbee-specs' },
+    @{ n = 'newbee 路径覆盖'; p = '.newbee-specs-path' },
+    @{ n = 'gen3（Spec Kit 风）'; p = 'specs' },
+    @{ n = 'gen1（Kiro 风）'; p = 'spec' },
+    @{ n = 'gen2（opencode Pack）'; p = 'docs\sdd' },
+    @{ n = 'constitution（项目宪章）'; p = 'constitution.md' }
+  )
+  foreach ($m in $markers) {
+    $exists = Test-Path -LiteralPath (Join-Path $Root $m.p)
+    if ($exists) { Write-Output ("  存在：{0,-20} -> {1}" -f $m.n, $m.p) }
+  }
+  $agents = Join-Path $Root 'AGENTS.md'
+  if (Test-Path -LiteralPath $agents) {
+    $t = Read-Text $agents
+    if ($t -match '(?i)(sdd|spec[- ]driven)') { Write-Output '  存在：AGENTS.md 声明 SDD 相关内容（以它为项目权威）' }
+  }
+  Write-Output '  原则：一仓一案；非 newbee 正本不碰；点名 newbee 则房客模式（工件只落 newbee 领地）。'
+}
+
+# ---------- resolve ----------
+function Invoke-Resolve([string]$Root) {
+  $r = Resolve-SpecsRoot $Root
+  Write-Output ("工件根：{0}（via {1}）" -f $r.Root, $r.Via)
+  $dirs = Get-FeatureDirs $r.Root
+  Write-Output ("功能夹层：{0} 个" -f $dirs.Count)
+  $max = 0
+  foreach ($d in $dirs) { if ([int]($d.Name.Substring(0,3)) -gt $max) { $max = [int]($d.Name.Substring(0,3)) } }
+  Write-Output ("下一个编号：{0:D3}" -f ($max + 1))
+}
+
+# ---------- check ----------
+function Invoke-Check([string]$Root, [string[]]$ExtraVague) {
+  $r = Resolve-SpecsRoot $Root
+  $specRoot = $r.Root
+  if (-not (Test-Path -LiteralPath $specRoot)) { throw "工件根不存在：$specRoot（先建夹层或检查 .newbee-specs-path）" }
+
+  $req = @{}; $rule = @{}; $tc = @{}; $task = @{}
+  $files = Get-ChildItem -LiteralPath $specRoot -Recurse -File -Filter '*.md' |
+    Where-Object { $_.Name -ne 'INDEX.md' }
+  $vagueHits = New-Object System.Collections.Generic.List[string]
+  $reqCoveredByTc = New-Object System.Collections.Generic.List[string]
+  $ruleWithReqSource = New-Object System.Collections.Generic.List[string]
+  $vague = $DefaultVagueWords + @($ExtraVague | Where-Object { $_ })
+  $schemeMissing = New-Object System.Collections.Generic.List[string]
+
+  foreach ($f in $files) {
+    $t = Read-Text $f.FullName
+    if ($null -eq $t) { continue }
+    if (-not (Get-Scheme $f.FullName)) { $schemeMissing.Add($f.FullName) | Out-Null }
+
+    foreach ($m in [regex]::Matches($t, '\bREQ-(\d{3})\b'))    { $req["REQ-$($m.Groups[1].Value)"] = $f.Name }
+    foreach ($m in [regex]::Matches($t, '\bRULE-(\d{3})\b'))   { $rule["RULE-$($m.Groups[1].Value)"] = $f.Name }
+    foreach ($m in [regex]::Matches($t, '\bTC-(\d{3})\b'))     { $tc["TC-$($m.Groups[1].Value)"] = $f.Name }
+    foreach ($m in [regex]::Matches($t, '\bTASK-(\d{3})\b'))   { $task["TASK-$($m.Groups[1].Value)"] = $f.Name }
+
+    foreach ($ln in ($t -split "`r?`n")) {
+      if ($ln -match '^\s*\|\s*TC-\d{3}') {
+        foreach ($m in [regex]::Matches($ln, '\bREQ-\d{3}\b')) { $reqCoveredByTc.Add($m.Value) | Out-Null }
+      }
+      elseif ($ln -match '^\s*\|\s*RULE-\d{3}') {
+        if ([regex]::IsMatch($ln, '\bREQ-\d{3}\b')) {
+          $ruleWithReqSource.Add([regex]::Match($ln, '^\s*\|\s*(RULE-\d{3})').Groups[1].Value) | Out-Null
+        }
+      }
+    }
+
+    foreach ($w in $vague) {
+      foreach ($m in [regex]::Matches($t, [regex]::Escape($w))) {
+        $line = ($t.Substring(0, $m.Index) -split "`n").Count
+        $vagueHits.Add("$($f.Name):$line → '$w'") | Out-Null
+      }
+    }
+  }
+
+  function Get-DefinedIds($map, $defFile) { return @($map.Keys | Where-Object { $map[$_] -eq $defFile }) }
+
+  $specDefinedReq = Get-DefinedIds $req 'spec.md'
+  $specDefinedRule = Get-DefinedIds $rule 'spec.md'
+
+  $reqNoTc = @($specDefinedReq | Where-Object { -not ($reqCoveredByTc -ccontains $_) })
+  $orphanRule = @($specDefinedRule | Where-Object { -not ($ruleWithReqSource -ccontains $_) })
+
+  $coveredReqPct = if ($specDefinedReq.Count) { [math]::Round(100 * ($specDefinedReq.Count - $reqNoTc.Count) / $specDefinedReq.Count) } else { -1 }
+  $orphanRulePct = if ($specDefinedRule.Count) { [math]::Round(100 * ($specDefinedRule.Count - $orphanRule.Count) / $specDefinedRule.Count) } else { -1 }
+
+  Write-Output "== check：$specRoot"
+  Write-Output ("REQ 定义 {0} 条；TC 覆盖率 {1}%（无 TC：{2}）" -f $specDefinedReq.Count, $coveredReqPct, ($reqNoTc -join ', ')) 
+  Write-Output ("RULE 定义 {0} 条；有 REQ 引用 {1}%（孤儿：{2}）" -f $specDefinedRule.Count, $orphanRulePct, ($orphanRule -join ', '))
+
+  $seen = @{}
+  foreach ($d in (Get-FeatureDirs $specRoot)) {
+    $n = $d.Name.Substring(0, 3)
+    if ($seen.ContainsKey($n)) { Add-Issue 'FAIL' "编号重复：$($seen[$n]) 与 $($d.Name)" }
+    $seen[$n] = $d.Name
+  }
+
+  if ($schemeMissing.Count) { Add-Issue 'WARN' ("scheme 行缺失（手工建档未走模板？）：" + ($schemeMissing -join ', ')) }
+  if ($vagueHits.Count) { Add-Issue 'FAIL' ("模糊词 {0} 处：" + ($vagueHits -join '；')) }
+  if ($reqNoTc.Count) { Add-Issue 'FAIL' ("REQ 无 TC 覆盖：" + ($reqNoTc -join ', ')) }
+  if ($orphanRule.Count) { Add-Issue 'FAIL' ("孤儿 RULE（无 REQ 引用）：" + ($orphanRule -join ', ')) }
+
+  $indexPath = Join-Path $specRoot 'INDEX.md'
+  if (Test-Path -LiteralPath $indexPath) {
+    $it = Read-Text $indexPath
+    foreach ($d in (Get-FeatureDirs $specRoot)) {
+      $code = $d.Name.Substring(0, 3)
+      if ($it -notmatch [regex]::Escape($code)) { Add-Issue 'WARN' "INDEX.md 未登记夹层 $($d.Name)" }
+    }
+  } else {
+    Add-Issue 'WARN' "缺 INDEX.md（建议从 templates/INDEX.md 复制）"
+  }
+
+  if (-not $Quiet) {
+    if ($script:Issues.Count) { Write-Output '--- 发现 ---'; $script:Issues | ForEach-Object { Write-Output $_ } }
+    else { Write-Output '--- 发现 ---（无）' }
+  }
+  if ($script:Issues -match '^\[FAIL\]' ) { exit 1 }
+}
+
+# ---------- verify ----------
+function Invoke-Verify([string[]]$Roots) {
+  $declMap = @{}
+  foreach ($root in $Roots) {
+    Write-Output "== verify：$root"
+    try { $r = Resolve-SpecsRoot $root } catch { Add-Issue 'FAIL' "[$root] $($_.Exception.Message)"; continue }
+    if ($r.Via -eq 'override') {
+      if ($declMap.ContainsKey($r.Root)) { Add-Issue 'FAIL' ("重复指向：{0} 与 {1} 都指向 {2}" -f $declMap[$r.Root], $root, $r.Root) }
+      else { $declMap[$r.Root] = $root }
+    }
+    $schemeCounts = @{}
+    if (Test-Path -LiteralPath $r.Root) {
+      foreach ($f in (Get-ChildItem -LiteralPath $r.Root -Recurse -File -Filter '*.md')) {
+        $s = Get-Scheme $f.FullName
+        if ($s) { if ($schemeCounts.ContainsKey($s)) { $schemeCounts[$s]++ } else { $schemeCounts[$s] = 1 } }
+      }
+    }
+    $summary = ($schemeCounts.GetEnumerator() | Sort-Object Name | ForEach-Object { "{0}:{1} 档" -f $_.Key, $_.Value }) -join '，'
+    Write-Output ("  工件根：{0}（via {1}）scheme 统计：{2}" -f $r.Root, $r.Via, ($(if ($summary) { $summary } else { '（无工件或无 scheme 行）' })))
+  }
+  if ($script:Issues.Count) { Write-Output '--- 发现 ---'; $script:Issues | ForEach-Object { Write-Output $_ }; exit 1 }
+  Write-Output '--- 发现 ---（无）'
+}
+
+# ---------- migrate ----------
+function Invoke-Migrate([string]$Root, [string]$From, [string]$To) {
+  if (-not $To) { throw "migrate 需要 -ToScheme（例：v2）" }
+  $r = Resolve-SpecsRoot $Root
+  $files = Get-ChildItem -LiteralPath $r.Root -Recurse -File -Filter '*.md'
+  $changed = 0
+  foreach ($f in $files) {
+    $t = Read-Text $f.FullName
+    if ($null -eq $t) { continue }
+    $new = [regex]::Replace($t, "(scheme:\s*newbee-sdd\s*)$([regex]::Escape($From))", "`$1$To")
+    if ($new -ne $t) {
+      [IO.File]::WriteAllText($f.FullName, $new, [Text.UTF8Encoding]::new($false))
+      $changed++
+      Write-Output "  updated: $($f.FullName)"
+    }
+  }
+  Write-Output "migrate 完成：$changed 个文件 scheme 行 $From → $To（结构变更请按 upgrade.md 指导另行执行；迁移前请先 git commit）"
+}
+
+# ---------- 入口 ----------
+switch ($Mode) {
+  'detect'  { if (-not $ProjectRoot) { throw "detect 需要 -ProjectRoot" }; Invoke-Detect $ProjectRoot }
+  'resolve' { if (-not $ProjectRoot) { throw "resolve 需要 -ProjectRoot" }; Invoke-Resolve $ProjectRoot }
+  'check'   { if (-not $ProjectRoot) { throw "check 需要 -ProjectRoot" }; Invoke-Check $ProjectRoot $VagueWords }
+  'verify'  { if (-not $ProjectRoots) { throw "verify 需要 -ProjectRoots（一个以上）" }; Invoke-Verify $ProjectRoots }
+  'migrate' { if (-not $ProjectRoot) { throw "migrate 需要 -ProjectRoot" }; Invoke-Migrate $ProjectRoot $FromScheme $ToScheme }
+}

package/templates/CONVENTIONS.md

@@ -0,0 +1,23 @@
+# newbee-sdd 项目规范（CONVENTIONS）
+
+<!--
+  放在工件根（newbee-specs/ 或 .newbee-specs-path 覆盖处）。
+  本文件是「项目对 newbee 的定制」：可附加/加严，不可删减核心契约（见 skill references/schemes.md）。
+  不需要定制可删除本文件，全部走 skill 默认值。
+-->
+
+scheme: newbee-sdd v1
+
+```newbee-conventions
+language: zh-CN              # 工件正文语言
+extra-status:                # 加严式新增状态（可选，逗号分隔）
+extra-sections:              # spec.md 新增必需章节（可选，逗号分隔）
+extra-vague-words:           # 增补模糊词（并入审查扫描，可选，逗号分隔）
+ticket-link: optional        # required = RTM 必须挂票号，状态以票系为权威
+gates:                       # 追加闸门说明（自由文本，只能加严）
+```
+
+## 说明（自由文本）
+
+- 本项目特殊约定：…
+- 引用的项目权威源（如敏捷看板/Issue 追踪系统/CI 规范）：…

package/templates/INDEX.md

@@ -0,0 +1,11 @@
+# newbee-specs 索引表（INDEX）
+
+<!--
+  放在工件根（newbee-specs/ 或 .newbee-specs-path 覆盖处）。
+  本文件维护所有 feature 夹层的当前状态，与各 spec.md frontmatter 保持对账一致。
+-->
+
+scheme: newbee-sdd v1
+
+| 编号 | 功能名称 | 轨道 (S/L) | 状态 (draft/approved/implementing/done) | 负责人 | 更新日期 | 备注 |
+|---|---|---|---|---|---|---|

package/templates/plan.md

@@ -0,0 +1,74 @@
+---
+scheme: newbee-sdd v1
+feature: "NNN-…（与 spec.md 一致）"
+status: draft
+---
+
+# NNN 技术方案（plan）
+
+> 仅 L 轨需要。基于已冻结（approved）的 spec.md；关键选型与架构设计先与用户确认再定稿。
+
+## 1. 约束盘点
+
+- 非功能约束：NFR-### …
+- 现有技术栈 / 团队技能 / 运维能力：…
+- 既定决策约束：DEC-### …
+
+## 2. 候选与依据（research）
+
+| 候选方案 | 依据（官方文档链接，不凭印象） | 已知风险 |
+|---|---|---|
+| 方案 A | … | … |
+| 方案 B | … | … |
+
+## 3. 评分矩阵（technology-selection）
+
+| 维度(权重) | 方案 A | 方案 B | 方案 C |
+|---|---|---|---|
+| 性能与伸缩性 (30%) | | | |
+| 维护与改造成本 (25%) | | | |
+| 复杂度与风险 (20%) | | | |
+| 团队匹配度 (25%) | | | |
+| **加权总分** | | | |
+
+**结论**：最终选定方案 X，满足 NFR-### / DEC-###，并沉淀为 DEC-###。
+
+## 4. 架构设计要点（system-design & architecture）
+
+### 4.1 架构分层与组件图（C4 Container / Component）
+
+```mermaid
+graph TD
+    User[用户/上游] --> Gateway[API 网关/接入层]
+    Gateway --> MOD1[MOD-001 核心业务模块]
+    MOD1 --> DB[(主数据库)]
+    MOD1 --> ExtService[外部依赖服务]
+```
+
+### 4.2 模块职责清单（MOD）
+
+| 模块 ID | 模块名称 | 单一职责 | 依赖关系 | 错误处理策略 |
+|---|---|---|---|---|
+| MOD-001 | … | … | MOD-### | … |
+
+### 4.3 关键流程时序图
+
+```mermaid
+sequenceDiagram
+    autonumber
+    Client->>Service: 请求
+    Service->>DB: 读写
+    DB-->>Service: 响应
+    Service-->>Client: 返回结果
+```
+
+### 4.4 失败模式与容灾设计（外部依赖必填）
+
+| 外部依赖 | 超时时间 | 重试策略 | 幂等性保证 | 熔断/降级方案 | 补偿机制 |
+|---|---|---|---|---|---|
+| … | … ms | 指数退避 (最多 3 次) | 唯一业务流水号 | 降级默认返回值 / 本地缓存 | 人工对账队列 |
+
+## 5. 验证与落地安排
+
+- 关键技术假设验证 → PoC/spike 任务：…
+- 阶段交付物与自测方式：…

package/templates/spec.md

@@ -0,0 +1,59 @@
+---
+scheme: newbee-sdd v1
+feature: "NNN-kebab-case-英文短名"
+status: draft            # draft | approved | implementing | done | blocked | deprecated
+owner: "@用户"
+---
+
+# NNN 功能名（可用中文）
+
+> 使用说明：本模板复制到 `<工件根>\NNN-名\spec.md` 后填写；占位符 `…` 全部替换，不留空段落与 [TODO]。
+
+## 1. 背景与动机
+
+（一段话：为什么要做，不做会怎样。）
+
+## 2. 用户故事
+
+- 作为 **角色**，我需要 …，以便 …。
+
+## 3. 功能需求（REQ）
+
+| ID | 需求 | 优先级（MoSCoW） | 验收条件（Given/When/Then） |
+|---|---|---|---|
+| REQ-001 | … | Must | Given … When … Then … |
+
+### 非功能需求（NFR）
+
+| ID | 需求 | 目标 | 量测方式 |
+|---|---|---|---|
+| NFR-001 | … | 数值+单位 | 如何量测（日志/压测/监控） |
+
+## 4. 业务规则（RULE）
+
+| ID | 规则 | 触发条件 → 动作 | 来源 |
+|---|---|---|---|
+| RULE-001 | … | … → … | REQ-### |
+
+## 5. 决策记录（DEC）
+
+| ID | 决策 | Context | Consequences |
+|---|---|---|---|
+| DEC-001 | … | … | … |
+
+## 6. 测试用例（TC）
+
+| ID | 前置 | 步骤 | 预期 | 来源 |
+|---|---|---|---|---|
+| TC-001 | … | … | … | REQ-001 / RULE-001 |
+
+> S 轨至此闭环；L 轨继续 plan.md 与 tasks.md。
+
+## 7. 契约外引用（可选）
+
+- 引用的项目权威源（票系/既有文档/架构设计）：…
+
+## 8. 变更记录（approved 之后的每次修改记一行）
+
+| 日期 | 变更 | 原因 | 影响面 |
+|---|---|---|---|

package/templates/tasks.md

@@ -0,0 +1,28 @@
+---
+scheme: newbee-sdd v1
+feature: "NNN-…（与 spec.md 一致）"
+status: draft
+---
+
+# NNN 任务拆解（tasks）
+
+## Part 1 — 任务清单
+
+| TASK ID | 标题 | 来源 | 类型（code/test/infra/doc/spike） | 依赖项 | 验收条件 |
+|---|---|---|---|---|---|
+| TASK-001 | … | REQ-001, MOD-001 | code | — | 可核验的具体验收条件（拒绝“完成开发”空话） |
+
+> 粒度原则：单一职责、可独立验收、单人 0.5~2 天内可闭环。
+
+## Part 2 — RTM 需求追溯矩阵（Requirement Traceability Matrix）
+
+| REQ | RULE | DEC | TC | TASK | Implementation (PR/commit 落实回填) | Release 状态 (pending/in-progress/done/blocked) | External ID (关联外部工单/Issue) |
+|---|---|---|---|---|---|---|---|
+| REQ-001 | RULE-001 | DEC-001 | TC-001 | TASK-001 | (待回填) | pending | (票号) |
+
+> 状态以项目实际版本控制与工单系统为权威，RTM 构成全链路可对账视图。
+
+## Part 3 — 未追溯项 [untracked] 清单
+
+| 候选项目 | 说明 | 裁决动作（补来源 ID / 或显式废弃删除） |
+|---|---|---|

package/upgrade.md

@@ -0,0 +1,46 @@
+# newbee-sdd 升级与版本迁移指南
+
+> 本指南适用于从旧版本或历史 SDD 目录升级至 `newbee-sdd` v1.0.0+。
+
+---
+
+## 升级理念：规则升级，资产不动
+
+`newbee-sdd` 的升级机制严格遵循**「代码与规范升级、业务资产隔离保护」**原则：
+* 执行升级只会更新规范主入口（`SKILL.md`）、审查清单（`references/`）、模板（`templates/`）和校验 CLI 工具。
+* 任何时候**绝不自动修改或覆盖**您项目中已经生成的 `specs/`、`newbee-specs/` 或 `docs/sdd/` 规格文件。
+
+---
+
+## 一键升级命令
+
+如果您是通过 npm 安装或直接使用 npx：
+
+```bash
+# 自动检测本机已安装的宿主（dsh, opencode, claude, cursor, codex）并一键无痛升级规则
+npx newbee-sdd update
+```
+
+---
+
+## 历史项目工件迁移说明
+
+如果您手头有在旧版（如原 SDD 10 步流程或自研规格）下生成的存量工件：
+
+1. **直接兼容（无需迁移）**：
+   `newbee-sdd` 支持向后兼容模式。只需在项目中运行：
+   ```bash
+   npx newbee-sdd verify
+   ```
+   工具会自动识别 `specs/`、`docs/sdd/` 或根目录的 `spec.md` 并执行追溯链闭环校验。
+
+2. **正式纳管到 newbee 体系（可选）**：
+   在已有工件的 frontmatter 中加入身份声明：
+   ```markdown
+   ---
+   scheme: newbee-sdd v1
+   feature: "001-your-feature-name"
+   status: approved
+   ---
+   ```
+   即可完整享受全链路 ID 机器对账和 Fresh-Context 子代理复审能力。