spec-wave 2.1.1

package/assets/skills/harness-20-task-audit/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: harness-20-task-audit
+description: 书面审查 Harness task 文件（R 轮）：对照 SPEC 核对范围/非范围/验收/failure_paths/思考轮，结论落盘 docs/harness/reviews/ 审查文。当 task 草稿完成、进入 HG-AUDIT-R1 人签之前使用。不用于：改 task 实质内容（退回 10-task）；审 SPEC（用 harness-20-spec-audit）；代签 human_gate（仅人）。
+license: MIT
+compatibility: Requires npx spec-wave CLI（task lint / verify --task）· docs/harness/reviews/ 目录约定
+metadata:
+  hat_id: 20-task-audit
+  track: starter
+---
+
+# 帽子：20-task-audit · 任务审核（Harness · Starter 子集）
+
+> **hat_id（V2）**：**20-task-audit** = task 书面审核（**30 之前**）。  
+> **对应**：**10-task** · **不**审 SPEC。  
+> **姊妹帽**：SPEC 书面审 **[`harness-20-spec-audit/SKILL.md`](../../skills/harness-20-spec-audit/SKILL.md)**（对应 10-spec · HG-SPEC-SIGNOFF）。  
+> **完整版 POINTER**（Ink 工作区）：`docs/harness/prompts/20-task-audit.md`  
+> **本文件**：嵌入用户仓 `docs/harness/prompts/` 的 **精简真值**（自 `22-task-audit.md` 改名 · V2 拆分）。
+
+## 身份
+
+**任务审核** Agent：对 task 做 **书面审查**；**不实现代码**；**必须落盘** `docs/harness/reviews/`。
+
+## 只做什么
+
+- 对照验收、`failure_paths`、`test_strategy`、必读列表
+- **行为变更类 task**（改默认值 / 校验 / 策略门 / fallback 语义）：验收标准须含「**旧测 grep 影响面**」项，缺则**退回 10-task** 补列（checklist 提醒 · 不进 `task lint` 机械闸）
+- **阶段 C**：若 task §4 含思考轮 → **思考轮审查**（控制表 · 回填闭合 · early_stop 理由/风险）
+- **思考审查不通过** → 审查文 **「退回 10-task」**；下一棒 **10-task**，**禁止**附 30 Prompt
+- **必须** 写 `task_<slug>_audit_R<n>_YYYYMMDD.md`
+- 零阻塞：写明核对项；**流程闸**与 **内容**分开写
+- 有阻塞：回填清单 + task 小节标题
+- 通过后在审查文写 **签收 / 关闭**（若本轮为终轮）
+
+## 禁止什么
+
+- 禁止仅口头「过了」不落盘
+- 有 **内容**阻塞时禁止指示 30 开工
+- **`HG-AUDIT-R1` 仍为 `pending` 时禁止附「下一棒 30」可复制 Prompt**（见下节）
+- 不代替 **50 复检** 做代码走查；不代替 **20-spec-audit** 审 SPEC
+
+## 人工闸联动（20-task-audit → 30 分界）
+
+| 维度 | 20 R1 负责 | 维护者负责 |
+|------|------------|------------|
+| task **内容**可执行 | 书面审查 · 零内容阻塞 | — |
+| **流程闸** `HG-AUDIT-R1` | 审查文写明 pending/approved | **签 task 表** → `approved` |
+| 30 改码授权 | **不签发** | task 表 `approved` 才是真值 |
+
+审查通过后请维护者签 **`HG-AUDIT-R1`** → `approved`（blocks **30**）。
+
+### `HG-AUDIT-R1` = pending 时，审查文文末只输出
+
+**维护者签闸清单**（禁止附 30 Prompt）：
+
+```text
+## 维护者签闸（20 后 · 30 前）
+
+- [ ] 已读 R1 审查结论
+- [ ] 在 task 人工闸表将 HG-AUDIT-R1 改为 approved（维护者 · 日期）
+- [ ] commit task 文档或确认已签
+- [ ] 再下发 Harness 30 Prompt
+
+30 Agent 将以 task 表为准；pending 时必须拒开工（见 TEMPLATE_30_gate_stop.md）。
+```
+
+### `HG-AUDIT-R1` = approved 后，审查文或维护者才可附 30 Prompt
+
+前提在 Prompt 内写明：**task 表已 approved**（非「计划签」）。
+
+## 输出形状
+
+元信息 → 结论摘要（内容 / 流程闸分列）→ 阻塞/非阻塞 → 回填清单 → 签闸清单或（已签时）下一棒 30 Prompt
+
+## 交接物
+
+- 审查 md 路径（**必须** · `docs/harness/reviews/`）
+- invoke 快照：仅当 task `required_invoke_hats` / profile **含 20** 时必须落盘；默认 default 集合不含 20（与 reviews 硬闸分工）
+- 按 HANDOFF 分仓 commit
+
+## 修订记录
+
+| 日期 | 摘要 |
+|------|------|
+| 2026-07-24 | V2 拆分收编：自 `22-task-audit.md` 改名为 `20-task-audit.md`（来源：工作区 `20-task-audit.md` · 2026-06-21 v3 + 原包内人工闸联动节保留） |
+| 2026-07-26 | v2.12：澄清 20 invoke 仅在 required 集合含 20 时强制；默认靠 reviews |
+| 2026-08-27 | K7：checklist 增行为变更类 task「旧测 grep 影响面」提醒（非机械闸） |
+
+## 给 Cursor
+
+`Harness`、`20-task-audit`、`reviews`、`_audit_`、`HG-AUDIT-R1`、`拒开工`

package/assets/skills/harness-20-task-audit/references/TEMPLATE_30_gate_stop.md

@@ -0,0 +1,36 @@
+# 模板：30 拒开工 · 人工闸 STOP
+
+> **用途**：`HG-AUDIT-R1` 或其它 blocks **30** 的闸为 `pending` 时，**首输出**须为本形状；**禁止**改业务码、禁止落 30 invoke。  
+> **复制**：Agent 按此填空；维护者演练拒开工时可对照。
+
+---
+
+## 人工闸扫描（30 · 拒开工）
+
+| human_gate_id | task表status | 用户/invoke声称 | 一致？ | blocks_30 | 30 可开工？ |
+|---------------|--------------|-----------------|--------|-----------|-------------|
+| HG-TASK-DRAFT | {读表} | {若有} | {Y/N} | {Y/N} | … |
+| **HG-AUDIT-R1** | **{读表}** | {若有} | {Y/N} | Y | **{❌ 否 / ✅ 是}** |
+
+**冲突**：task 表 `pending` 且声称 `approved` → **拒开工**（不得采信聊天）。
+
+**pre-30 invoke（v2.14+ 硬闸 · 本包已接线）**：`verify` 报 `missing pre-30 invoke hats` → **拒开工**——本包已接线（src/cli.ts cmdVerify · checkPre30InvokeHats · PRD_DEF-003 阶段二 T5 · test/cli-verify-invoke-hats.test.ts 钉死 · `--allow-invoke-gap` 豁免留痕）；人工闸表核对口径不变。
+
+**结论**：**拒开工** — task 表真值未满足 30 条件。
+
+**真值依据**：`docs/tasks/active/task_*.md` 人工闸表（**聊天 Prompt 不能替代 `approved`**）+ `npx spec-wave verify --task`。
+
+**维护者下一步**：
+
+1. 在 task 表将阻塞闸改为 `approved`（附维护者 · 日期）
+2. 补齐 pre-30 invoke（通常 `invoke_*_10_*`）或改 `minimal` / `--allow-invoke-gap`
+3. `git add` + `commit` task 文档（或维护者确认已签）
+4. 重新下发 Harness 30 Prompt
+
+**禁止**：将「维护者发送 30 Prompt」或用户口头「开工」视为闸已签收。
+
+---
+
+## 给 Cursor
+
+`Harness`、`30`、`拒开工`、`HG-AUDIT-R1`、`human_gate`

package/assets/skills/harness-hat-reanchor/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: harness-hat-reanchor
+description: 长对话帽身份丢失时先读本片段 re-anchor（hat_id / task_slug / 禁区）。当上下文脏、多轮读码后纪律漂移、或换帽后仍自称旧帽时使用。不用于：替代 prompts 全文；替代 npx spec-wave verify。
+license: MIT
+compatibility: Requires docs/harness/prompts/ 已 sync；机械闸仍走 CLI verify
+metadata:
+  hat_id: reanchor
+  track: starter
+---
+
+# FRAGMENT · 帽身份 Re-anchor
+
+上下文脏（多轮读码 / 大 diff / 口头换帽）则**先读本片段**，再继续。本片段 ≠ prompts 全文 ≠ `verify`。
+
+- **hat_id**：{00 / 10-task / 10-spec / 20-task-audit / 20-spec-audit / 30 / 40}
+- **task_slug**：{active task 文件名或「无」}
+- **本帽禁区**：{从当前帽 prompts「禁止什么」抄一行}
+
+只做本 `hat_id` 允许的事。换帽须加载该帽 prompts **全文**。机械闸：`npx spec-wave verify`。

package/assets/standards/POINTER_workspace_truth_v1_zh.md

@@ -0,0 +1,42 @@
+# POINTER · 工作区编码规范真值（示例 · 不复制全文）
+
+| 项 | 内容 |
+| --- | --- |
+| **状态** | `active` |
+| **日期** | 2026-06-15（A3 脱敏） |
+| **性质** | **只读指针**；Starter 交付 TEMPLATE，各业务仓维护 L1/L2 **active** 条文 |
+
+---
+
+## 纪律（D-M2-04）
+
+| 规则 | 说明 |
+| --- | --- |
+| **禁止双维护** | 不得将某业务仓 `docs/standards/` L1/L2 **全文**复制进 `cyning-harness` 产品仓 |
+| **嵌入用户仓** | 从本目录 **TEMPLATE_*** 复制生成用户仓 `docs/standards/`；按需 **POINTER** 回链源仓 |
+| **冲突** | task + 图谱 + PROJECT_CONFIG > 用户仓已嵌入 L1/L2 > 本 POINTER |
+
+---
+
+## 使用方式
+
+1. **默认**：仅用本目录 [`TEMPLATE_CODING_BASELINE_L1_v1_zh.md`](TEMPLATE_CODING_BASELINE_L1_v1_zh.md) 等模板  
+2. **有上游规范仓时**：在用户仓 README 追加 POINTER 链（GitHub 路径 · 非本地绝对路径）  
+3. **禁止** 将私有工作区 invoke / task 正文 bulk 复制进产品包
+
+---
+
+## 治理仓（可选 · 公开）
+
+| 仓 | 用途 |
+| --- | --- |
+| [`cyning-ai-coding-governance`](https://github.com/Cyning12/cyning-ai-coding-governance) | 方法论 · L3/L2/L1 整合导读 · 对比研究 |
+
+---
+
+## 修订记录
+
+| 日期 | 说明 |
+| --- | --- |
+| 2026-06-09 | M2 T2：TEMPLATE + POINTER 首版 |
+| 2026-06-15 | A3 public push：移除私有工作区路径与 Ink 内部 task 枚举 |

package/assets/standards/README.md

@@ -0,0 +1,35 @@
+# standards · 编码规范模板
+
+按语言栈从本目录复制到用户仓 **`docs/standards/`**。
+
+## v0.1 已交付（T2 · M2）
+
+| 模板 | 状态 | 嵌入后文件名 |
+|------|------|--------------|
+| [`TEMPLATE_CODING_BASELINE_L1_v1_zh.md`](./TEMPLATE_CODING_BASELINE_L1_v1_zh.md) | ✅ | `CODING_BASELINE_L1_v1_zh.md` |
+| [`TEMPLATE_CODING_BASELINE_L2_frontend_v1_zh.md`](./TEMPLATE_CODING_BASELINE_L2_frontend_v1_zh.md) | ✅ | `CODING_FRONTEND_L2_v1_zh.md` |
+| [`TEMPLATE_CODING_BASELINE_L2_backend_v1_zh.md`](./TEMPLATE_CODING_BASELINE_L2_backend_v1_zh.md) | ✅ | `CODING_BACKEND_L2_v1_zh.md` |
+| [`SOURCES_v1_zh.md`](./SOURCES_v1_zh.md) | ✅ | `SOURCES_编码规范外部参考_v1_zh.md` |
+| [`POINTER_workspace_truth_v1_zh.md`](./POINTER_workspace_truth_v1_zh.md) | ✅ | 可选保留 POINTER（不复制 Ink 全文） |
+
+## 嵌入步骤
+
+```bash
+mkdir -p docs/standards
+cp standards/TEMPLATE_CODING_BASELINE_L1_v1_zh.md docs/standards/CODING_BASELINE_L1_v1_zh.md
+# 按栈复制 L2 模板并重命名；填写「本仓落地」列
+cp standards/SOURCES_v1_zh.md docs/standards/SOURCES_编码规范外部参考_v1_zh.md
+```
+
+## task 字段
+
+`code_quality_bar: strict | recommended | not_applicable`
+
+- **strict**：22/30 须对照 L2 条文 ID
+- **recommended**：M2 文档演练默认
+- **not_applicable**：纯文档 task 须附一行理由
+
+## 关联
+
+- Onboarding：见薄指针页 [`POINTER_ONBOARDING.md`](../docs/POINTER_ONBOARDING.md)（原文不随包发布）§4
+- Harness 衔接：工作区 `GUIDANCE_standards_in_harness_starter_m2_v1_zh.md` §3（POINTER，非复制）

package/assets/standards/SOURCES_v1_zh.md

@@ -0,0 +1,49 @@
+# 编码规范 — 外部参考模板（v1）
+
+> **用途**：复制为 `docs/standards/SOURCES_编码规范外部参考_v1_zh.md`。  
+> **纪律**：**引用不搬运** — 正文不进仓，只保留采纳条款与本仓落地路径。
+
+| 项 | 内容 |
+| --- | --- |
+| **状态** | `draft` |
+| **关联 L1** | `CODING_BASELINE_L1_v1_zh.md` |
+
+---
+
+## 1. 引用纪律
+
+1. **引用不搬运**：下表「来源 URL」为真值入口；修订时更新 **版本锚点**。
+2. **采纳须可执行**：「本仓落地」须指向 **文件路径、CI job 或命令**。
+3. **冲突**：与 task、`_tech_graph`、`PROJECT_CONFIG` 冲突时，以本仓真值为准。
+
+---
+
+## 2. 映射表（嵌入时填写）
+
+| ID | 来源 | 版本锚点 | 采纳条款（摘要） | 本仓落地 |
+| --- | --- | --- | --- | --- |
+| REF-GOOG-CL | [Google Eng Practices — CLs](https://google.github.io/eng-practices/review/developer/) | YYYY-MM | 小步 CL、附测试说明 | PR Test plan；L1 §4 |
+| REF-GOOG-CR | [Google Code Review](https://google.github.io/eng-practices/review/) | YYYY-MM | 可读性、非风格吹毛求疵 | 22 审查关注 B-01/B-02 |
+| REF-PEP8 | [PEP 8](https://peps.python.org/pep-0008/) | Py x.y | 格式、命名 | _后端：ruff.toml_ |
+| REF-GOOG-TS | [Google TS Style](https://google.github.io/styleguide/tsguide.html) | YYYY-MM | strict、禁 any | _前端：tsconfig + ESLint_ |
+| REF-OWASP-API | [OWASP API Top 10](https://owasp.org/www-project-api-security/) | 2023 | 注入、鉴权 | B-11 |
+| _REF-…_ | _待增_ | | | |
+
+---
+
+## 3. 按 L1 条文回查
+
+| L1 条文 | 主要 REF |
+| --- | --- |
+| B-01～B-07 | REF-GOOG-CL, REF-GOOG-CR |
+| B-08 | REF-GOOG-TS, REF-PEP8 |
+| B-10 | REF-GOOG-CL |
+| B-11 | REF-OWASP-API |
+
+---
+
+## 4. 修订记录
+
+| 版本 | 日期 | 说明 |
+| --- | --- | --- |
+| v1.0 | YYYY-MM-DD | 从 cyning-harness SOURCES 模板嵌入 |

package/assets/standards/TEMPLATE_CODING_BASELINE_L1_v1_zh.md

@@ -0,0 +1,88 @@
+# 编码基线 L1 模板（语言无关 · v1）
+
+> **用途**：复制到用户仓 `docs/standards/CODING_BASELINE_L1_v1_zh.md` 并按栈裁剪。  
+> **纪律**：本文件为 **脚手架模板**；Ink 工作区真值见 [`POINTER_workspace_truth_v1_zh.md`](./POINTER_workspace_truth_v1_zh.md) — **禁止** 将真值全文复制进产品仓分发包。
+
+| 项 | 内容 |
+| --- | --- |
+| **状态** | `draft` — 嵌入后改 `active` 并人签 |
+| **版本** | v1.0 |
+| **日期** | YYYY-MM-DD |
+| **维护** | 本仓 `docs/standards/` |
+
+---
+
+## 1. 适用范围
+
+| 适用 | 不适用 |
+| --- | --- |
+| 本仓 **业务代码** 新增/修改 | 纯文档 task（`test_strategy: not_applicable` 且无代码） |
+| Agent 与人类 PR | 第三方 vendored（除非 task 明示） |
+
+**优先级**：**task + `_tech_graph` + PROJECT_CONFIG** > 本 L1 > 外部参考（[`SOURCES_v1_zh.md`](./SOURCES_v1_zh.md)）> 个人习惯。
+
+---
+
+## 2. 条文（B-01～B-12 · 填写真值）
+
+> 每条保留 **ID**；L2 须标注 `遵循 B-xx`。下方「本仓落地」列嵌入时必填。
+
+| ID | 原则（摘要） | 本仓落地（路径 / CI / 命令） |
+| --- | --- | --- |
+| **B-01** | 单一职责；函数/模块只做一件事 | _待填_ |
+| **B-02** | 早返回；嵌套 ≤2 | _待填_ |
+| **B-03** | 配置外置；禁止硬编码 URL/密钥 | _待填：`PROJECT_CONFIG` / `.env.example`_ |
+| **B-04** | 命名即文档；与图谱/API 术语一致 | _待填_ |
+| **B-05** | 错误可结构化；对齐 registry/SPEC | _待填_ |
+| **B-06** | 扩展点显式；表驱动优于 if-else 链 | _待填_ |
+| **B-07** | 最小 diff；禁止范围外重构 | _待填_ |
+| **B-08** | 类型与契约优先；禁止滥用 `any`/裸 dict | _待填_ |
+| **B-09** | 重复 ≥3 处须抽取 | _待填_ |
+| **B-10** | 测试与行为绑定；`test_strategy: required` 先测后码 | _待填：pytest / vitest / …_ |
+| **B-11** | 安全与密钥；输入校验 | _待填_ |
+| **B-12** | 可观测钩子；禁止静默失败 | _待填_ |
+
+### 扩展示例（可选）
+
+若需展开单条说明，用三级标题 `### B-0N …`，**勿** 超过 L1 原则层（栈细节放 L2）。
+
+---
+
+## 3. 反模式速查（节选）
+
+| ID | 反模式 | 改法 | 条文 |
+| --- | --- | --- | --- |
+| AP-01 | 魔法字符串 API 路径 | 常量 / env / 生成类型 | B-03, B-08 |
+| AP-02 | 路由层堆业务+SQL | 下沉 service | B-01 |
+| AP-03 | 深层嵌套 JSX / try | 抽 hook / 早 return | B-02 |
+| AP-04 | `except Exception: pass` | 窄捕获 + 结构化错误 | B-05 |
+
+_嵌入后按栈增补 AP-xx_
+
+---
+
+## 4. PR / 审查自检
+
+- [ ] 无新增硬编码 URL/魔法数（B-03）
+- [ ] 无密钥进仓库（B-11）
+- [ ] 无范围外文件改动（B-07）
+- [ ] `test_strategy: required` 时测试已绿（B-10）
+
+---
+
+## 5. 与 L2 的关系
+
+| 层级 | 路径 | 职责 |
+| --- | --- | --- |
+| **L1** | 本文件 | 原则与条文 ID |
+| **L2 前端** | `docs/standards/CODING_FRONTEND_L2_v1_zh.md` | 由 [`TEMPLATE_CODING_BASELINE_L2_frontend_v1_zh.md`](./TEMPLATE_CODING_BASELINE_L2_frontend_v1_zh.md) 生成 |
+| **L2 后端** | `docs/standards/CODING_BACKEND_L2_v1_zh.md` | 由 [`TEMPLATE_CODING_BASELINE_L2_backend_v1_zh.md`](./TEMPLATE_CODING_BASELINE_L2_backend_v1_zh.md) 生成 |
+| **L3** | `.cursor/rules` · `AGENTS.md` | ≤15 行摘要 + 链至 L1/L2 |
+
+---
+
+## 6. 修订记录
+
+| 版本 | 日期 | 说明 |
+| --- | --- | --- |
+| v1.0 | YYYY-MM-DD | 从 cyning-harness 模板嵌入 |

package/assets/standards/TEMPLATE_CODING_BASELINE_L2_backend_v1_zh.md

@@ -0,0 +1,75 @@
+# 编码规范 L2 模板 — 后端（Python / API · v1）
+
+> **用途**：复制为 `docs/standards/CODING_BACKEND_L2_v1_zh.md`。  
+> **L1**：须链本仓 [`CODING_BASELINE_L1_v1_zh.md`](./TEMPLATE_CODING_BASELINE_L1_v1_zh.md)（嵌入后去 `TEMPLATE_` 前缀）。
+
+| 项 | 内容 |
+| --- | --- |
+| **状态** | `draft` |
+| **栈** | _例：Python 3.11+ · FastAPI · pytest · Ruff_ |
+| **配置真值** | _待填：`docs/meta/PROJECT_CONFIG_*.md`_ |
+| **图谱** | _待填：`docs/_tech_graph/`_ |
+
+---
+
+## 1. 适用范围
+
+| 路径 | 职责 |
+| --- | --- |
+| `api/` 或 `src/` | HTTP 路由与领域模块 |
+| `tests/` | pytest |
+| _（待填）_ | _按仓裁剪_ |
+
+---
+
+## 2. 条文（P-01～P-15 · 填写真值）
+
+每条须含：**遵循 B-xx** + **工具规则 ID**（Ruff / mypy 等）。
+
+| ID | 主题 | 遵循 | 本仓落地（文件 / 规则 ID） |
+| --- | --- | --- | --- |
+| **P-01** | 模块边界；路由薄 | B-01 | _待填_ |
+| **P-02** | 早返回与异常 | B-02 | _待填_ |
+| **P-03** | 环境变量单一真值模块 | B-03 | _待填：`api/rag_env.py` 或 settings_ |
+| **P-04** | 命名与 import 顺序 | B-04 | _待填_ |
+| **P-05** | 结构化错误 / HTTPException | B-05 | _待填：error registry_ |
+| **P-06** | 分支与策略 | B-06 | _待填_ |
+| **P-07** | 最小 diff | B-07 | _待填_ |
+| **P-08** | 类型注解 / Pydantic | B-08 | _待填：Ruff ANN / mypy_ |
+| **P-09** | 重复抽取 | B-09 | _待填_ |
+| **P-10** | pytest 与 marker | B-10 | _待填_ |
+| **P-11** | 安全与密钥 | B-11 | _待填_ |
+| **P-12** | 日志与 trace 字段 | B-12 | _待填_ |
+| **P-13** | _栈特有_ | — | _待填_ |
+| **P-14** | _栈特有_ | — | _待填_ |
+| **P-15** | _栈特有_ | — | _待填_ |
+
+### 扩展示例
+
+```markdown
+### P-05 结构化错误（遵循 B-05）
+
+| 场景 | 形状 |
+| --- | --- |
+| HTTP | HTTPException + error_code |
+| 内部 | 窄捕获；禁止 traceback 外泄 |
+```
+
+---
+
+## 3. CI 对齐
+
+| 检查 | 命令 | workflow |
+| --- | --- | --- |
+| Test | _例：`pytest tests -m "not slow"`_ | _待填_ |
+| Lint | _例：`ruff check`_ | _待填（可选 P4）_ |
+
+复制 [`ci/samples/pytest.yml.example`](../ci/samples/README.md) 并按上表改。
+
+---
+
+## 4. 修订记录
+
+| 版本 | 日期 | 说明 |
+| --- | --- | --- |
+| v1.0 | YYYY-MM-DD | 从 cyning-harness L2 后端模板嵌入 |

package/assets/standards/TEMPLATE_CODING_BASELINE_L2_frontend_v1_zh.md

@@ -0,0 +1,76 @@
+# 编码规范 L2 模板 — 前端（TypeScript / React · v1）
+
+> **用途**：复制为 `docs/standards/CODING_FRONTEND_L2_v1_zh.md`。  
+> **L1**：须链本仓 [`CODING_BASELINE_L1_v1_zh.md`](./TEMPLATE_CODING_BASELINE_L1_v1_zh.md)（嵌入后去 `TEMPLATE_` 前缀）。
+
+| 项 | 内容 |
+| --- | --- |
+| **状态** | `draft` |
+| **栈** | _例：Next App Router · React · TypeScript strict · pnpm · Vitest_ |
+| **配置真值** | _待填：`docs/meta/PROJECT_CONFIG_*.md`_ |
+| **图谱** | _待填：`docs/_tech_graph/`_ |
+
+---
+
+## 1. 适用范围
+
+| 路径 | 职责 |
+| --- | --- |
+| `app/` | 页面、布局、Route Handlers（BFF） |
+| `components/` | UI 组件 |
+| `lib/` | 领域逻辑、工具 |
+| _（待填）_ | _按仓裁剪_ |
+
+---
+
+## 2. 条文（F-01～F-14 · 填写真值）
+
+每条须含：**遵循 B-xx** + **工具规则 ID**（ESLint / tsconfig 等）。
+
+| ID | 主题 | 遵循 | 本仓落地（文件 / 规则 ID） |
+| --- | --- | --- | --- |
+| **F-01** | 模块边界；Route Handler 薄 | B-01 | _待填_ |
+| **F-02** | 早返回与条件渲染 | B-02 | _待填_ |
+| **F-03** | 环境变量；`NEXT_PUBLIC_*` 纪律 | B-03 | _待填_ |
+| **F-04** | 命名与 `@/` 导入 | B-04 | _待填_ |
+| **F-05** | BFF 错误与日志 | B-05, B-12 | _待填_ |
+| **F-06** | 分支与策略表 | B-06 | _待填_ |
+| **F-07** | 最小 diff | B-07 | _待填_ |
+| **F-08** | TypeScript strict | B-08 | _待填：`eslint/@typescript-eslint/no-explicit-any`_ |
+| **F-09** | 重复抽取 | B-09 | _待填_ |
+| **F-10** | 测试（Vitest / RTL） | B-10 | _待填_ |
+| **F-11** | 安全（XSS、密钥） | B-11 | _待填_ |
+| **F-12** | 可观测 | B-12 | _待填_ |
+| **F-13** | _栈特有_ | — | _待填_ |
+| **F-14** | _栈特有_ | — | _待填_ |
+
+### 扩展示例
+
+```markdown
+### F-03 环境变量（遵循 B-03）
+
+| 类型 | 规则 |
+| --- | --- |
+| 服务端密钥 | 仅服务端模块；禁止 NEXT_PUBLIC_* |
+| API 基址 | 单一真值 env + proxy 模块 |
+```
+
+---
+
+## 3. CI 对齐
+
+| 检查 | 命令 | workflow |
+| --- | --- | --- |
+| Lint | _例：`pnpm lint`_ | _待填_ |
+| Test | _例：`pnpm test`_ | _待填_ |
+| Build | _例：`pnpm build`_ | _待填_ |
+
+复制 [`ci/samples/quality.yml.example`](../ci/samples/README.md) 并按上表改 job 名。
+
+---
+
+## 4. 修订记录
+
+| 版本 | 日期 | 说明 |
+| --- | --- | --- |
+| v1.0 | YYYY-MM-DD | 从 cyning-harness L2 前端模板嵌入 |

package/bin/dsh-coding-kit.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runCli } from '../lib/cli.js'
+
+runCli(process.argv.slice(2)).catch((err) => {
+  if (err && err.message) console.error(err.message)
+  process.exit(typeof err?.exitCode === 'number' ? err.exitCode : 1)
+})

package/bin/specgate.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runCli } from '../lib/cli.js'
+
+runCli(process.argv.slice(2)).catch((err) => {
+  if (err && err.message) console.error(err.message)
+  process.exit(typeof err?.exitCode === 'number' ? err.exitCode : 1)
+})