feat(req-test-gate): 集成 Harness Engineering 工程约束方法论

将项目级的 Ratchet/约定检测方法论融入 req-test-gate 技能，
通过 /req 流程三个节点自动触发（dev 环境检测、cr 约定建议、test Gate 0B），
无需手动记忆执行。

新增文档：harness-engineering.md、ratchet-pattern.md、convention-flow.md、
project-bootstrap.md 及 4 个模板（ratchet/convention 脚本、GATES.md、pre-commit）。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

skills-req/req-plugin/skills/SKILL.md

@@ -47,6 +47,7 @@ analysis → design → dev → review → testing → [待部署池] → releas
 - **操作前先确认实际 ID** — 从 URL 提取 ID（如 `/requirements/897` → ID=897）
 - **务实路线关闭也必须补全关联任务** — 每个进度条阶段需创建关联任务
 - **阶段内容门禁（防空转）** — `/req next` 时检查关键阶段任务是否有实质内容
+- **Harness 环境检测** — `/req dev` 启动开发前，快速检测项目基础设施（`.husky/` 存在？`scripts/check-*.sh` 存在？）。若两者都不存在（Level 0），输出一行提示：「项目无质量护栏，建议先运行 `/harness init`」。检测结果不阻塞开发，仅提示
 
 ## 禁止直接调用（必须走命令流程）
 
@@ -92,13 +93,15 @@ Gate 4: 完整性检查 ── 三段式完整 + 验收标准 ≥ 2 条 + PRD
 6.  /req next        → 推进到 design/dev 阶段
 7.  /req dev         → 启动开发（创建【开发】任务, delivery_stage=dev）
 8.  /req next        → 推进到 review 阶段
-9.  /req cr          → 代码评审（创建【代码评审】任务）
+9.  /req cr          → 代码评审 + 约定检查 + bug约定建议（⭐ harness 自动）
 10. /req next        → 推进到 testing 阶段
-11. /req test        → 测试验收（5-Gate 流程）
+11. /req test        → 测试验收（Gate 0B 约定检查 ⭐ + Gate 1-5）
 12. /req deploy      → 批量部署（build-and-push.sh → Jenkins ai-proj）
 13. /req done        → 归档 (archived) + git commit + push
 ```
 
+> ⭐ 标记的步骤是 Harness Engineering 自动嵌入的，无需手动调用。
+
 **5 阶段文档**：
 
 | 阶段 | 文档名 | 技能 |
@@ -287,10 +290,19 @@ Gate 4: 完整性检查 ── 三段式完整 + 验收标准 ≥ 2 条 + PRD
 2. `git diff` / `find` 确定变更范围（文件数、行数）
 3. 读取所有变更文件源码（非 test 文件）
 4. **五视角扫描**：逐一用攻击者/泄露者/并发者/边界者/依赖者视角审查
-5. `ai-proj task create` 创建【代码评审】任务并关联需求（linkRole=code_review）
-6. `ai-proj create-and-attach` 附加 CR 报告文档（必须含五视角扫描结果）
-7. 展示发现摘要，AskUserQuestion 确认是否创建 bug 修复任务
-8. 若有 High/Critical 发现 → `ai-proj task create` 创建关联修复任务
+5. **约定检查**：运行所有 `scripts/check-*.sh --ci`，将结果写入 CR 报告
+6. **⭐ Bug 约定建议**（bug 类需求自动触发：category=bug，或标题含 fix/修复/bug，或描述含根因/复现步骤）：
+   - 分析本次 bug 的根因模式
+   - 判断可检测性：能写 grep 找到同类问题？（规则见 convention-flow.md「可检测性判断」）
+     - 不可检测 → 仅在 CR 报告记录根因，跳过
+     - 可检测 → 检查已有 `scripts/check-*.sh` 是否已覆盖 → 已覆盖则跳过
+   - 扫描代码库统计同类模式数量 N
+   - AskUserQuestion（N=0: 防未来复发；N>0: 防恶化+逐步清理）
+   - 是 → 执行 convention flow → 产出物**单独 commit**（`chore: 建立 {name} 约定`）
+7. `ai-proj task create` 创建【代码评审】任务并关联需求（linkRole=code_review）
+8. `ai-proj create-and-attach` 附加 CR 报告文档（必须含五视角扫描结果 + 约定检查结果）
+9. 展示发现摘要，AskUserQuestion 确认是否创建 bug 修复任务
+10. 若有 High/Critical 发现 → `ai-proj task create` 创建关联修复任务
 
 **`/req test [REQ-ID]`** — 测试（前置：代码评审通过），遵循 dev-test 技能的 5-Gate 流程
 
@@ -332,6 +344,7 @@ ai-proj task append-doc --id 5214 --content "# PRD: 用户认证功能\n..."
 | design | 【评审】技术设计: {需求标题} | design |
 | dev | 【开发-后端】{需求标题}、【开发-前端】{需求标题} | implementation |
 | review | 【代码评审】{需求标题} | code_review |
+| review | 【约定】{约定名称}（bug 类需求，convention flow 自动创建） | documentation |
 | testing | 【测试】集成测试: {需求标题} | test |
 | deploy | 由 `/req deploy` 批量创建 | deploy |
 
@@ -398,3 +411,4 @@ ai-proj req tasks --id <id>               # 查看关联任务
 | `req-prd` | PRD 文档编写 + 评审方法论 |
 | `req-prototype` | Stitch 原型生成 + 迭代 |
 | `dev-test` | 测试 + 质量门禁 |
+| `req-test-gate` (harness) | 工程约束方法论。Gate 0-2 的约定检查由项目本地脚本定义，方法论见 `/harness` 命令 |