@cyning/harness 0.3.0

package/schema/manifest.v1.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://cyning.dev/schemas/cyning-harness/manifest.v1.json",
+  "title": "cyning-harness VersionManifest",
+  "description": "业务仓钉住的产品包版本与接入参数（本体 VersionManifest · v0.3+）",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "preset", "ide"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "已同步的产品包 semver（或 git describe）"
+    },
+    "preset": {
+      "type": "string",
+      "description": "AdoptedProfile preset 名"
+    },
+    "ide": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["cursor", "claude", "agents"]
+      },
+      "uniqueItems": true,
+      "description": "启用的 IDE 轨"
+    },
+    "from_version": {
+      "type": ["string", "null"],
+      "description": "upgrade 前版本；init 时为 null"
+    },
+    "upgraded_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "最近一次 install/upgrade 写入时间（UTC ISO8601）"
+    }
+  }
+}

package/standards/POINTER_workspace_truth_v1_zh.md

@@ -0,0 +1,57 @@
+# POINTER · 工作区编码规范真值（Ink · 不复制全文）
+
+| 项 | 内容 |
+| --- | --- |
+| **状态** | `active` |
+| **日期** | 2026-06-09 |
+| **性质** | **只读指针**；Starter 交付 TEMPLATE，Ink 维护 L1/L2 **active** 条文 |
+
+---
+
+## 纪律（D-M2-04）
+
+| 规则 | 说明 |
+| --- | --- |
+| **禁止双维护** | 不得将 Ink `docs/standards/` L1/L2 **全文**复制进 `cyning-harness` 产品仓 |
+| **嵌入用户仓** | 从本目录 **TEMPLATE_*** 复制生成用户仓 `docs/standards/`；按需 **POINTER** 回链 Ink |
+| **冲突** | task + 图谱 + PROJECT_CONFIG > 用户仓已嵌入 L1/L2 > 本 POINTER |
+
+---
+
+## Ink 工作区真值（金样 · 只读）
+
+> 路径相对 **cyning-ink-workspace**（本地常名 `Projects/`）。无访问权限时仅用本仓 TEMPLATE。
+
+| 资产 | 路径 | 状态 |
+| --- | --- | --- |
+| **L1 基线** | `docs/standards/CODING_BASELINE_L1_v1_zh.md` | `active` · R1 2026-06-09 |
+| **L2 前端** | `ai-ink-brain/docs/standards/CODING_FRONTEND_L2_v1_zh.md` | `active` |
+| **L2 后端** | `ai-ink-brain-api-python/docs/standards/CODING_BACKEND_L2_v1_zh.md` | `active` |
+| **外部参考** | `docs/standards/SOURCES_编码规范外部参考_v1_zh.md` | `draft` |
+| **改进大纲** | `docs/standards/00_OUTLINE_工程编码规范改进_v1_zh.md` | 规划 |
+| **Harness 衔接** | `docs/harness/guides/GUIDANCE_standards_in_harness_starter_m2_v1_zh.md` | M2 打包真值 |
+
+---
+
+## 治理仓（可选 · 私有）
+
+| 仓 | 用途 |
+| --- | --- |
+| [`cyning-ai-coding-governance`](https://github.com/Cyning12/cyning-ai-coding-governance) | 方法论 · L3/L2/L1 整合导读 · 对比研究 |
+
+本地镜像（若有）：`Projects/ai_coding_governance/methodology/`
+
+---
+
+## M2 金样来源（后续 T6）
+
+- 编码规范 Epic：`ai-ink-brain-api-python/docs/tasks/active/task_standards_backend_api_modularization_manifest_v1.md`
+- 过程 invoke：工作区 `docs/harness/invokes/by-task/`（**不**复制进产品仓）
+
+---
+
+## 修订记录
+
+| 日期 | 说明 |
+| --- | --- |
+| 2026-06-09 | M2 T2：TEMPLATE + POINTER 首版 |

package/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：[`docs/ONBOARDING.md`](../docs/ONBOARDING.md) §4
+- Harness 衔接：工作区 `GUIDANCE_standards_in_harness_starter_m2_v1_zh.md` §3（POINTER，非复制）

package/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/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/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/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/wizard/ONBOARDING_wizard_v1_zh.md

@@ -0,0 +1,112 @@
+# 安装向导 · Onboarding 问卷（v1 · 文档版）
+
+> **状态**：`active`（M2 v0.1）  
+> **形态**：**脚本优先**（[`wizard/README.md`](./README.md)）；本文档为 preset 说明备查  
+> **关联**：[`docs/ONBOARDING.md`](../docs/ONBOARDING.md) · GUIDANCE D3 IDE 轨
+
+---
+
+## 使用方式
+
+**推荐**：在业务仓根执行脚本（见 [`README.md`](./README.md)）：
+
+```bash
+/path/to/cyning-harness/wizard/install.sh --preset ios-cursor
+# 日后 git pull 产品包后：
+CYNING_HARNESS=/path/to/cyning-harness wizard/harness-sync.sh apply
+```
+
+下文为 **preset 含义** 与手工备查。默认不全选 IDE 入口。
+
+---
+
+## 步骤 1 · 仓库类型
+
+| 选项 | 说明 | 下一步 |
+|------|------|--------|
+| **A 新仓** | 空仓或刚初始化 | → 步骤 2 · 必做图谱骨架 + 模块表 + 1 主 flow |
+| **B 存量** | 已有代码 | → 步骤 1b 选档位 |
+
+### 1b · 存量档位（仅 B）
+
+| 档位 | 特征 | 首次 30 改码前 |
+|------|------|----------------|
+| **S0** 小 | <5 万行、边界清 | 模块表人签 + 1 主 flow |
+| **S1** 中 | 多 BFF/路由 | 模块表 + 主路径 flow |
+| **S2** 大 | 技术债重 | **仅**模块表 + 待补清单 |
+| **S3** 巨 / monorepo | 多子仓 | 每子仓模块表 + 顶层 pointer |
+
+---
+
+## 步骤 2 · 语言栈（可多选）
+
+| 勾选 | 复制来源 | 目标路径 |
+|------|----------|----------|
+| ☐ 前端 TS/Next | `graph/templates/` · `standards/TEMPLATE_*_L2_frontend*` · `ci/samples/quality.yml.example` | `docs/_tech_graph/` · `docs/standards/` · `.github/workflows/` |
+| ☐ 后端 Python | `graph/templates/` · `standards/TEMPLATE_*_L2_backend*` · `ci/samples/pytest.yml.example` | 同上 |
+| ☐ 全栈 | 两项均勾选 | 前后端均复制并按仓裁剪 |
+| ☐ 其他 | 仅 L1 + 过程轨 | `standards/TEMPLATE_CODING_BASELINE_L1*` · `harness/` |
+
+```bash
+# 示例：克隆本产品后（路径按本地调整）
+CYNING_HARNESS=/path/to/cyning-harness
+mkdir -p docs/_tech_graph docs/coding_wiki docs/standards docs/tasks/active docs/harness/prompts docs/harness/invokes/by-task
+cp -R "$CYNING_HARNESS/graph/templates/"* docs/_tech_graph/
+cp -R "$CYNING_HARNESS/coding_wiki/templates/"* docs/coding_wiki/
+cp "$CYNING_HARNESS/harness/templates/TASK_graph_bootstrap.md" docs/tasks/active/task_graph_bootstrap.md
+```
+
+---
+
+## 步骤 3 · IDE 入口（按实际 IDE 勾选 · 默认不全选）
+
+| 勾选 | 脚本 / 复制 | 写入位置 |
+|------|-------------|----------|
+| ☑ **Cursor**（推荐） | `install.sh --ide cursor` 或 sync | `.cursor/rules/05-harness-starter.mdc` |
+| ☐ Claude Code | `install.sh --ide claude` | 仓根 `CLAUDE.md`（marker merge） |
+| ☐ 通用 Agent | `install.sh --ide agents` | 仓根 `AGENTS.md`（marker merge） |
+
+```bash
+# 推荐：脚本勾选（v0.2+）
+/path/to/cyning-harness/wizard/install.sh --preset harness-only --ide cursor,claude,agents
+
+# 手工备查
+mkdir -p .cursor/rules
+cp "$CYNING_HARNESS/ide/adapters/cursor-harness-starter.mdc.example" .cursor/rules/05-harness-starter.mdc
+```
+
+---
+
+## 步骤 4 · 过程轨与 Verify
+
+| 项 | 操作 |
+|----|------|
+| Harness prompts | `cp harness/prompts/*.md docs/harness/prompts/` |
+| invoke 模板 | `cp harness/invokes/TEMPLATE_invoke.md docs/harness/invokes/` |
+| CI | 见步骤 2 栈勾选 · 复制 `ci/samples/*.example` → `.github/workflows/` |
+
+---
+
+## 步骤 5 · 人签与首张 task
+
+1. 填写 `docs/_tech_graph/01_struct.md` 模块表  
+2. 维护者签 **`HG-GRAPH-MODULES`** → `approved`（见 `TASK_graph_bootstrap.md`）  
+3. 新建业务 task：从 `harness/templates/TASK_TEMPLATE.md` 复制  
+4. IDE 中 `@` task + `docs/harness/prompts/30-execute-code.md` 开 30 帽  
+
+---
+
+## 完成检查清单
+
+- [ ] 五轨目录存在（图谱 / wiki / standards / harness / CI）
+- [ ] 至少 **一种** IDE 入口已生成
+- [ ] `HG-GRAPH-MODULES` approved（存量/新仓按档位）
+- [ ] 本地或 CI 跑通一门禁命令
+
+---
+
+## 修订记录
+
+| 版本 | 日期 | 说明 |
+|------|------|------|
+| v1.0 | 2026-06-09 | M2 T5 文档版问卷 · 替代 v0.0.1 纯手工说明 |