Merge pull request 'feat(governance): 技能治理节拍落到 launchd + 提案入口模板' (#20) from feat/skill-governance-schedulers into main

- scripts/scheduled-task.sh：daily/weekly/monthly 只做确定性动作，需模型判断的部分生成 queue 文件
- scripts/install-schedulers.sh：装成用户级 launchd（daily 07:20 / weekly 周一 10:00 / monthly 1 日 10:00）
- .gitea issue/PR 模板：新技能提案走同一套 SCOPE 门槛问题
- README 一键部署 2 步 → 4 步；MAINTENANCE 增加定时任务一节与边界说明

.gitea/issue_template/config.yaml

@@ -0,0 +1,2 @@
+blank_issues_enabled: true
+contact_links: []

.gitea/issue_template/new-skill.md

@@ -0,0 +1,36 @@
+---
+name: 新技能提案
+about: 提新技能或技能改动前先过 SCOPE.md 门槛（默认拒绝，能组合就不新增）
+title: "[技能] "
+labels: skill
+---
+
+## 1. 真实失败（必填）
+
+在哪个真实任务/会话里出了问题？跑了什么、期望什么、实际什么。
+
+> 假设性的「这样会更好」不算。说不清就说明还不到提的时候。
+
+## 2. 为什么组合不出来（必填）
+
+用现有哪个技能组合试过？为什么做不到？
+
+> 能组合出来的，改现有技能，不新增。
+
+## 3. 是否重复提案
+
+- [ ] 已读 `.out-of-scope/` 三份拒绝档案，不是重复提案
+
+## 4. 分桶与调用模式
+
+- 初始分桶：`beta`（新技能一律先 beta）
+- 调用模式：`model-invoked` / `user-invoked`
+  - 判定：这件事是不是「人下命令才开始」？是 → `user-invoked`（同时写 `disable-model-invocation: true`）
+
+## 5. 最低交付
+
+- [ ] `evals/evals.json` 3 条：正常路径 / 边界 / 失败恢复
+- [ ] `docs/skills/<name>.md` 四段式：What it does / When to reach for it / Common questions / It's working if
+- [ ] `docs/skill-routing.md` 已回改
+- [ ] `catalog.json` 已 regenerate
+- [ ] `CHANGELOG.md` + `plugin.json` 版本号

.gitea/pull_request_template.md

@@ -0,0 +1,24 @@
+## 这个 PR 做了什么
+
+<!-- 一句话，说明改的是哪个技能 / 哪套流程 -->
+
+## SCOPE 门槛
+
+- [ ] 真实失败：说清了在哪个真实任务里出的问题
+- [ ] 组合不出来：说明用现有技能组合为什么做不到
+- [ ] 已查 `.out-of-scope/`，不是重复提案
+
+## 改动检查
+
+- [ ] 分桶正确（新技能一律 `beta`；`promoted` 需要真实使用记录 + evals 通过）
+- [ ] 调用模式正确（`user-invoked` 必须写 `disable-model-invocation: true`）
+- [ ] `evals/evals.json` 3 条（正常 / 边界 / 失败恢复）
+- [ ] `docs/skills/<name>.md` 四段式
+- [ ] `docs/skill-routing.md` 已回改
+- [ ] `catalog.json` 已 regenerate（`python3 scripts/generate-catalog.py`）
+- [ ] `CHANGELOG.md` + `plugin.json` 版本号已更新
+- [ ] 四道门禁通过：`validate-skills.py --strict`、`scan-skill.sh`、`generate-catalog.py --check`、`tests/install-skills.test.sh`
+
+## 人工拍板项（有则写明）
+
+<!-- deprecated 删除、路由变更、promoted 晋升，需要人确认 -->

.gitignore

@@ -25,3 +25,9 @@ __pycache__/
 
 # Node
 node_modules/
+
+# 定时任务产出（本机运行产物，不回写仓库；evals 结果报告除外）
+reports/skill-health/
+reports/monthly/
+reports/_scheduler/
+reports/evals/queue-*.md

CHANGELOG.md

@@ -48,3 +48,23 @@
 - 新增 `scripts/scan-installed.sh`：扫描已装但非本仓库管理的第三方技能（当前 33 个，0 高危）。
 - `generate-catalog.py` 增加 `has_evals` / `has_docs` 与 `coverage` 汇总；`validate-skills.py` 增加 `--coverage` 报告与路由表一致性检查。
 - `SCOPE.md` 增加覆盖率路线图（3–4 周补齐 40 个技能的 evals 与文档）；`MAINTENANCE.md` 同步。
+
+### 覆盖率阶段 2（2026-11-01）
+
+- 补齐剩余 24 个技能（dev 类为主）的 `evals/evals.json`（各 3 条）与 `docs/skills/<name>.md`（四段式）。
+- `--coverage`：40 个 promoted+model-invoked 技能的 evals 与文档缺口 **24 → 0**。
+
+### 继续推进（2026-11-01）
+
+- 新增 beta 技能 `diagnosing-bugs`（难查 bug 诊断纪律：先建红循环再推理），补齐 evals 与四段式文档；路由表同步。
+- 新增 `scripts/monthly-review.sh`：一条命令跑月度审阅（覆盖率 / 扫描 / 第三方 / catalog / description 异常）。
+
+### 治理落地：定时任务与提案入口（2026-11-01）
+
+- 新增 `scripts/scheduled-task.sh`：`daily` / `weekly` / `monthly` 三个确定性任务，只跑门禁、扫漂移、生成队列；需要模型判断的部分（真跑 evals、审阅 routing）生成 queue 文件交 agent。
+- 新增 `scripts/install-schedulers.sh`：把节拍装成 macOS 用户级 launchd（`com.pipexerp.ai-proj-skill-{daily,weekly,monthly}`），不再依赖会话提醒；支持 `--status` / `--run` / `--uninstall`。
+- 新增 `.gitea/issue_template/new-skill.md`、`.gitea/issue_template/config.yaml`、`.gitea/pull_request_template.md`：提案与 PR 走同一套 SCOPE 门槛问题。
+- `README.md` 一键部署从 2 步改为 4 步（补 git hooks 与定时任务）；`MAINTENANCE.md` 增加「定时任务」一节，写明脚本只做确定性动作的边界。
+- `.gitignore` 排除定时任务产出（`reports/skill-health/`、`reports/monthly/`、`reports/_scheduler/`、`reports/evals/queue-*.md`）。
+- 新增 `scripts/evals-status.py` 与 `reports/evals/TEMPLATE.md`：evals 覆盖率与回归报告模板。
+- `skill-creator` 实战记录 #1：用标准流程新建 `diagnosing-bugs`（beta，待观察后晋升）。

MAINTENANCE.md

@@ -3,7 +3,10 @@
 > 配套 `SCOPE.md`（收不收）、`skill-creator`（怎么建）、`docs/skill-routing.md`（用哪个）。
 > 本文件管「多久做一次什么」。
 
-## 每次改动（任何 PR）
+## 每次改动（任何分支）
+
+> **批量提交前先建分支**：`git checkout -b <branch>`，再提交、推分支、开 PR。不要直接 commit 到 main（2026-11-01 阶段 2 漏建分支直接进 main，少了 PR 记录）。
+
 
 1. 过 `SCOPE.md` 收录门槛（真实失败 + 组合不出来），新技能默认先 `beta`。
 2. 跑四道门禁：`validate-skills.py --strict`、`scan-skill.sh`、`generate-catalog.py --check`、`tests/install-skills.test.sh`。
@@ -22,7 +25,8 @@
 
 - 范围：上周改过的技能 + 3 个高风险技能（`dev-coding`、`dev-review`、`req-design`）。
 - 每技能取 1 条关键用例，做「有技能 / 无技能」对比，按 rubric 打分。
-- 结果记录到 `reports/evals/YYYY-Www.md`，进周报。
+- 结果记录到 `reports/evals/YYYY-Www.md`（模板 `reports/evals/TEMPLATE.md`），进周报。
+- 用 `python3 scripts/evals-status.py` 看哪些技能已有 evals、哪些已有回归报告。
 - 连续两次无增量的技能 → 按 `SCOPE.md` 评估降级。
 - 不做全量（61 技能 × 3 用例成本过高）；全量只在治理大改时做。
 
@@ -31,7 +35,7 @@
 - 两台机器 `--audit` 漂移必须为 0（beta/deprecated 除外）。
 - 审 `catalog.json`：`description` 长度 <80 或 >600 的标黄；含「各种 / 等等 / 相关」这类泛化词的标出。
 - 第三方技能（arkcli 等）有变动时，评估是否影响团队技能；跑一次 `./scripts/scan-installed.sh`。
-- 跑 `python3 scripts/validate-skills.py --coverage`：报告缺 evals / 缺四段式文档的技能，按 `SCOPE.md` 的覆盖率路线图推进。
+- 跑 `./scripts/monthly-review.sh` 一次出齐：覆盖率、本仓库扫描、第三方扫描、catalog 一致性、description 异常项。
 
 ## 每季度首月 1 日 10:30 — 治理复核
 
@@ -41,6 +45,27 @@
 - 复核覆盖率：`--coverage` 的两项缺口是否按路线图收敛。
 - 更新本文件与 `CHANGELOG.md`。
 
+## 定时任务（launchd，2026-11-01 起）
+
+节拍不再挂在「会话提醒」上（会话一断就失效），改成宿主级 launchd：
+
+```bash
+./scripts/install-schedulers.sh            # 安装（幂等；换机器重跑一次即可复现）
+./scripts/install-schedulers.sh --status   # 看状态与最近产出
+./scripts/install-schedulers.sh --run daily  # 立刻跑一次（调试）
+./scripts/install-schedulers.sh --uninstall
+```
+
+| 任务 | 时间 | 脚本做什么 | 产出 |
+| --- | --- | --- | --- |
+| `daily` | 每天 07:20 | 漂移 audit + 入库安全扫描 + 覆盖率 | `reports/skill-health/daily-YYYY-MM-DD.md`（`latest.md` 供 7:30 日报直接读） |
+| `weekly` | 每周一 10:00 | 算上周改动技能 + 3 个高风险项，生成 evals 抽样队列 | `reports/evals/queue-YYYY-MM-DD.md` |
+| `monthly` | 每月 1 日 10:00 | 一条命令跑完月度审阅；1/4/7/10 月附季度治理清单 | `reports/monthly/review-YYYY-MM.md`、`quarterly-YYYY-Qn.md` |
+
+**边界**：脚本只做确定性动作。真跑 evals、审阅 routing 这类需要模型判断的部分，脚本只生成队列文件，由项目经理 Bot 在 7:30 日报里接手执行——分工不写在脚本里就会漏。
+
+日志：`reports/_scheduler/<job>.log`。
+
 ## 责任分工
 
 - 项目经理 Bot：执行节奏、出周/月报、盯漂移与门禁。

README.md

@@ -69,7 +69,7 @@ PRD 文档存储在思源笔记中，可以导出发送到飞书群，通过飞
 - **Codex**（[Skills 文档](https://developers.openai.com/codex/skills)）或 **Claude Code** 已安装
 - **ai-proj 账号 + MCP API Key**：联系管理员获取（Key 格式: `aiproj_pk_xxx`）
 
-### 一键部署（2 步搞定）
+### 一键部署（4 步搞定）
 
 ```bash
 # 1. 克隆仓库
@@ -78,8 +78,16 @@ cd ai-proj-helper
 
 # 2. 默认安装到 Codex 的用户级标准目录 ~/.agents/skills
 ./install-skills.sh
+
+# 3. 装本地门禁（Gitea Actions 无 runner，commit/push 靠 git hook 兜底）
+./scripts/install-git-hooks.sh
+
+# 4. 装技能治理定时任务（macOS launchd：每日漂移检查 / 每周 evals 队列 / 每月审阅）
+./scripts/install-schedulers.sh
 ```
 
+第 3、4 步只对「本仓库的维护者」需要——只装技能给别人用的，跑完第 2 步就可以停。
+
 安装器会复制完整技能目录，包括 `SKILL.md`、references、scripts 和 assets。Codex 会自动发现 `~/.agents/skills` 中的技能；若没有出现，重启 Codex。
 
 Claude Code 用户显式选择 Claude 目标；需要同时配置 MCP 和 marketplace 时运行 `init.sh`：

catalog.json

@@ -2,100 +2,19 @@
   "repo": "ai-proj-helper",
   "coverage": {
     "required": 40,
-    "with_evals": 0,
+    "with_evals": 40,
-    "with_docs": 0,
+    "with_docs": 40,
-    "missing_evals": [
+    "missing_evals": [],
-      "ai-proj",
+    "missing_docs": []
-      "pm-ask",
-      "pm-risk",
-      "agent-browser",
-      "agent-swarm",
-      "ai-chat",
-      "db-migration",
-      "defect-analysis",
-      "deploy-rollback",
-      "dev-arch",
-      "dev-cicd",
-      "dev-coding",
-      "dev-commit",
-      "dev-deploy",
-      "dev-integration",
-      "dev-mcp",
-      "dev-review",
-      "dev-scaffold",
-      "dev-test",
-      "executing-plans",
-      "finishing-a-development-branch",
-      "frontend-design",
-      "karpathy-guidelines",
-      "pull-request",
-      "review-checklist",
-      "slark-cicd",
-      "slark-dsh-cicd",
-      "req-audit",
-      "req-compare",
-      "req-design",
-      "req-dev",
-      "req-lookback",
-      "req",
-      "req-prd",
-      "req-prototype",
-      "req-research",
-      "req-retro",
-      "req-review",
-      "req-test-gate",
-      "req-workflow"
-    ],
-    "missing_docs": [
-      "ai-proj",
-      "pm-ask",
-      "pm-risk",
-      "agent-browser",
-      "agent-swarm",
-      "ai-chat",
-      "db-migration",
-      "defect-analysis",
-      "deploy-rollback",
-      "dev-arch",
-      "dev-cicd",
-      "dev-coding",
-      "dev-commit",
-      "dev-deploy",
-      "dev-integration",
-      "dev-mcp",
-      "dev-review",
-      "dev-scaffold",
-      "dev-test",
-      "executing-plans",
-      "finishing-a-development-branch",
-      "frontend-design",
-      "karpathy-guidelines",
-      "pull-request",
-      "review-checklist",
-      "slark-cicd",
-      "slark-dsh-cicd",
-      "req-audit",
-      "req-compare",
-      "req-design",
-      "req-dev",
-      "req-lookback",
-      "req",
-      "req-prd",
-      "req-prototype",
-      "req-research",
-      "req-retro",
-      "req-review",
-      "req-test-gate",
-      "req-workflow"
-    ]
   },
-  "generated_at": "2026-10-31T21:04:04Z",
+  "generated_at": "2026-10-31T21:33:50Z",
-  "total": 61,
+  "total": 62,
   "counts": {
     "promoted/user-invoked": 18,
     "deprecated/user-invoked": 1,
     "promoted/model-invoked": 40,
     "beta/user-invoked": 1,
+    "beta/model-invoked": 1,
     "deprecated/model-invoked": 1
   },
   "skills": [
@@ -174,8 +93,8 @@
       "description_len": 77,
       "path": "skills-core/ai-proj-plugin/skills/SKILL.md",
       "digest": "77ce4d2eb10e1d29",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "pm-ask",
@@ -187,8 +106,8 @@
       "description_len": 98,
       "path": "skills-core/pm-ask-plugin/skills/SKILL.md",
       "digest": "e5b69a0b56985472",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "pm-risk",
@@ -200,8 +119,8 @@
       "description_len": 72,
       "path": "skills-core/pm-risk-plugin/skills/SKILL.md",
       "digest": "928cfec76018329f",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "publish",
@@ -239,8 +158,8 @@
       "description_len": 71,
       "path": "skills-dev/agent-browser-plugin/skills/SKILL.md",
       "digest": "f382bffe3d1c84b2",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "agent-swarm",
@@ -252,8 +171,8 @@
       "description_len": 153,
       "path": "skills-dev/agent-swarm-plugin/skills/SKILL.md",
       "digest": "4164f82025a421bb",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "ai-chat",
@@ -265,8 +184,8 @@
       "description_len": 78,
       "path": "skills-dev/ai-chat-plugin/skills/SKILL.md",
       "digest": "81193de50b43d95c",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "ai-proj-cicd-release",
@@ -304,8 +223,8 @@
       "description_len": 77,
       "path": "skills-dev/db-migration-plugin/skills/SKILL.md",
       "digest": "f8d6ebbddbbf7a71",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "defect-analysis",
@@ -317,8 +236,8 @@
       "description_len": 68,
       "path": "skills-dev/defect-analysis-plugin/skills/SKILL.md",
       "digest": "23dfafda92d0c622",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "deploy-rollback",
@@ -330,8 +249,8 @@
       "description_len": 49,
       "path": "skills-dev/deploy-rollback-plugin/skills/SKILL.md",
       "digest": "75ebf66a3f74195a",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "dev-android",
@@ -356,8 +275,8 @@
       "description_len": 69,
       "path": "skills-dev/dev-arch-plugin/skills/SKILL.md",
       "digest": "c9a419c83a307a11",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "dev-cicd",
@@ -369,8 +288,8 @@
       "description_len": 119,
       "path": "skills-dev/dev-cicd-plugin/skills/SKILL.md",
       "digest": "a763f0f140516411",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "dev-coding",
@@ -382,8 +301,8 @@
       "description_len": 81,
       "path": "skills-dev/dev-coding-plugin/skills/SKILL.md",
       "digest": "cc43720aa12bb8f6",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "dev-commit",
@@ -395,8 +314,8 @@
       "description_len": 99,
       "path": "skills-dev/dev-commit-plugin/skills/SKILL.md",
       "digest": "1560658c4a30df45",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "dev-deploy",
@@ -408,8 +327,8 @@
       "description_len": 90,
       "path": "skills-dev/dev-deploy-plugin/skills/SKILL.md",
       "digest": "fd15a9e9135bcc49",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "dev-integration",
@@ -421,8 +340,8 @@
       "description_len": 64,
       "path": "skills-dev/dev-integration-plugin/skills/SKILL.md",
       "digest": "eff6be8eb57b7fef",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "dev-ios",
@@ -447,8 +366,8 @@
       "description_len": 84,
       "path": "skills-dev/dev-mcp-plugin/skills/SKILL.md",
       "digest": "83d5912212fcfa4a",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "dev-pda",
@@ -473,8 +392,8 @@
       "description_len": 91,
       "path": "skills-dev/dev-review-plugin/skills/SKILL.md",
       "digest": "a8a1ec79b85e3227",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "dev-scaffold",
@@ -486,8 +405,8 @@
       "description_len": 43,
       "path": "skills-dev/dev-scaffold-plugin/skills/SKILL.md",
       "digest": "4044787b1e468302",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "dev-test",
@@ -499,8 +418,21 @@
       "description_len": 67,
       "path": "skills-dev/dev-test-plugin/skills/dev-test/SKILL.md",
       "digest": "a03536a478eabe6c",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
+    },
+    {
+      "name": "diagnosing-bugs",
+      "category": "dev",
+      "version": "0.1.0",
+      "status": "beta",
+      "invocation": "model-invoked",
+      "description": "难查 bug 的诊断纪律：先造出一条「现在就为这个 bug 变红」的紧反馈循环，再二分定位、最小验证、补回归测试。当 bug 难复现、间歇失败、或第一次看没头绪时使用。",
+      "description_len": 84,
+      "path": "skills-dev/diagnosing-bugs-plugin/skills/SKILL.md",
+      "digest": "d93fb95c073858cc",
+      "has_evals": true,
+      "has_docs": true
     },
     {
       "name": "executing-plans",
@@ -512,8 +444,8 @@
       "description_len": 104,
       "path": "skills-dev/executing-plans-plugin/skills/SKILL.md",
       "digest": "8991a50091af83a4",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "finishing-a-development-branch",
@@ -525,8 +457,8 @@
       "description_len": 80,
       "path": "skills-dev/finishing-branch-plugin/skills/SKILL.md",
       "digest": "1102047ccc060e60",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "frontend-design",
@@ -538,8 +470,8 @@
       "description_len": 234,
       "path": "skills-dev/frontend-design-plugin/skills/SKILL.md",
       "digest": "84e9c104be7967cc",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "karpathy-guidelines",
@@ -551,8 +483,8 @@
       "description_len": 64,
       "path": "skills-dev/karpathy-guidelines-plugin/skills/SKILL.md",
       "digest": "a68f347031110d6a",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "pull-request",
@@ -564,8 +496,8 @@
       "description_len": 219,
       "path": "skills-dev/pull-request-plugin/skills/SKILL.md",
       "digest": "40dac0d290782bb5",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "review-checklist",
@@ -577,8 +509,8 @@
       "description_len": 54,
       "path": "skills-dev/review-checklist-plugin/skills/SKILL.md",
       "digest": "5bae13b6a8d92650",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "slark-cicd",
@@ -590,8 +522,8 @@
       "description_len": 285,
       "path": "skills-dev/slark-cicd-plugin/skills/SKILL.md",
       "digest": "1ff9b89a5fbc6e2d",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "slark-dsh-cicd",
@@ -603,8 +535,8 @@
       "description_len": 306,
       "path": "skills-dev/slark-dsh-cicd-plugin/skills/SKILL.md",
       "digest": "9819e2d515ab44e0",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "data-excel",
@@ -720,8 +652,8 @@
       "description_len": 55,
       "path": "skills-req/req-audit-plugin/skills/SKILL.md",
       "digest": "ff2e6197bbb059c6",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "req-compare",
@@ -733,8 +665,8 @@
       "description_len": 79,
       "path": "skills-req/req-compare-plugin/skills/SKILL.md",
       "digest": "3428e3f37ef9e9e8",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "req-design",
@@ -746,8 +678,8 @@
       "description_len": 96,
       "path": "skills-req/req-design-plugin/skills/SKILL.md",
       "digest": "74848800cab6e269",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "req-dev",
@@ -759,8 +691,8 @@
       "description_len": 74,
       "path": "skills-req/req-dev-plugin/skills/SKILL.md",
       "digest": "494a5be5e7a11c0b",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "req-lookback",
@@ -772,8 +704,8 @@
       "description_len": 47,
       "path": "skills-req/req-lookback-plugin/skills/SKILL.md",
       "digest": "cc6bff614a8f7bf4",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "req",
@@ -785,8 +717,8 @@
       "description_len": 90,
       "path": "skills-req/req-plugin/skills/SKILL.md",
       "digest": "193cf871b73faff1",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "req-prd",
@@ -798,8 +730,8 @@
       "description_len": 76,
       "path": "skills-req/req-prd-plugin/skills/SKILL.md",
       "digest": "7c4ad2baab6b2118",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "req-prototype",
@@ -811,8 +743,8 @@
       "description_len": 81,
       "path": "skills-req/req-prototype-plugin/skills/SKILL.md",
       "digest": "7e362f4f895fb50a",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "req-research",
@@ -824,8 +756,8 @@
       "description_len": 71,
       "path": "skills-req/req-research-plugin/skills/SKILL.md",
       "digest": "a94924f53bd4c80e",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "req-retro",
@@ -837,8 +769,8 @@
       "description_len": 57,
       "path": "skills-req/req-retro-plugin/skills/SKILL.md",
       "digest": "636b7099d85e9549",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "req-review",
@@ -850,8 +782,8 @@
       "description_len": 65,
       "path": "skills-req/req-review-plugin/skills/SKILL.md",
       "digest": "cd1a5181d72f35f4",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "req-test-gate",
@@ -863,8 +795,8 @@
       "description_len": 159,
       "path": "skills-req/req-test-gate-plugin/skills/SKILL.md",
       "digest": "ceebcc2516ad40d3",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "req-workflow",
@@ -876,8 +808,8 @@
       "description_len": 61,
       "path": "skills-req/req-workflow-plugin/skills/SKILL.md",
       "digest": "87499da3817d162d",
-      "has_evals": false,
+      "has_evals": true,
-      "has_docs": false
+      "has_docs": true
     },
     {
       "name": "verification-before-completion",

docs/skill-routing.md

@@ -21,6 +21,7 @@
 | 设计 / 拆任务 | `req-design`、`dev-arch`、`db-migration` |
 | 编码 | `dev-coding`、`karpathy-guidelines` |
 | 测试 | `dev-test`、`req-test-gate` |
+| 难查的 bug / 间歇失败 | `diagnosing-bugs`（先建红循环再推理） |
 | 代码评审 | `dev-review`、`review-checklist` |
 | 发布（Slark 仓库/Desktop） | `slark-cicd` |
 | 发布（DSH 插件/宿主补丁） | `slark-dsh-cicd` |

docs/skills/agent-browser.md

@@ -0,0 +1,21 @@
+# agent-browser
+
+## What it does
+
+浏览器自动化（snapshot-ref）。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/agent-swarm.md

@@ -0,0 +1,21 @@
+# agent-swarm
+
+## What it does
+
+多 agent 编排（Swarm 模式）。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/ai-chat.md

@@ -0,0 +1,21 @@
+# ai-chat
+
+## What it does
+
+AI Chat 工具调用测试与配置。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/ai-proj.md

@@ -0,0 +1,24 @@
+# ai-proj — 任务与需求管理
+
+## What it does
+
+通过 ai-proj（`https://ai.pipexerp.com`）的 MCP / CLI 管理需求、任务、文档与进度：查询、创建、更新状态、关联需求与任务、挂证据文档。是所有项目状态数据的唯一权威来源。
+
+## When to reach for it
+
+- 要查「某个 REQ / 任务的真实状态、优先级、截止、关联任务」
+- 要更新任务状态、挂文档、改优先级、改派
+- 汇报进度或做对齐检查前，需要拉真实数据
+
+## Common questions
+
+- **数据以哪为准？** ai-proj，不靠聊天记录或记忆。主机必须是 `https://ai.pipexerp.com`（写成 `api.pipexerp.com` 会失败）。
+- **可以自己改需求优先级吗？** 不行，需求优先级是业务决策；任务优先级可以对齐需求。
+- **任务 completed 就是完成了吗？** 不是，REQ 未 `released` 只能算步骤完成。
+- **接口报错怎么排查？** 先 GET 查证实体是否存在、凭证主机是否正确，不要猜 ID。
+
+## It's working if
+
+- 问「REQ-XXXX 现在什么状态」时，它给出带字段名与时间戳的真实数据，而不是复述对话
+- 更新任务状态前先查一次实体，写入后回读确认
+- 遇到 404/401 时给的是排查步骤与真实查询结果，不是编造的 ID

docs/skills/db-migration.md

@@ -0,0 +1,21 @@
+# db-migration
+
+## What it does
+
+数据库变更与回滚。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/defect-analysis.md

@@ -0,0 +1,21 @@
+# defect-analysis
+
+## What it does
+
+设计缺陷多维度分析。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/deploy-rollback.md

@@ -0,0 +1,21 @@
+# deploy-rollback
+
+## What it does
+
+部署回滚决策与步骤。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/dev-arch.md

@@ -0,0 +1,21 @@
+# dev-arch
+
+## What it does
+
+架构设计与技术选型。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/dev-cicd.md

@@ -0,0 +1,21 @@
+# dev-cicd
+
+## What it does
+
+CI/CD 流水线设计、优化与排障。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/dev-coding.md

@@ -0,0 +1,21 @@
+# dev-coding
+
+## What it does
+
+编码实现与任务跟踪。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/dev-commit.md

@@ -0,0 +1,21 @@
+# dev-commit
+
+## What it does
+
+智能提交（分支保护 + Conventional）。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/dev-deploy.md

@@ -0,0 +1,21 @@
+# dev-deploy
+
+## What it does
+
+应用部署（TestFlight / Docker）。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/dev-integration.md

@@ -0,0 +1,21 @@
+# dev-integration
+
+## What it does
+
+前后端联调。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/dev-mcp.md

@@ -0,0 +1,21 @@
+# dev-mcp
+
+## What it does
+
+MCP Bridge 开发。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/dev-review.md

@@ -0,0 +1,21 @@
+# dev-review
+
+## What it does
+
+六视角对抗性代码评审。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/dev-scaffold.md

@@ -0,0 +1,21 @@
+# dev-scaffold
+
+## What it does
+
+模块脚手架。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/dev-test.md

@@ -0,0 +1,21 @@
+# dev-test
+
+## What it does
+
+测试设计与执行。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/diagnosing-bugs.md

@@ -0,0 +1,26 @@
+# diagnosing-bugs
+
+## What it does
+
+给难查的 bug 一套诊断纪律：先造出「现在就为这个 bug 变红」的紧反馈循环，再二分定位、一次验一个假设、最小改动修复，最后补一条曾经红过的回归测试。
+
+## When to reach for it
+
+- 间歇失败、偶发问题，第一次看没头绪
+- 已知两个好版本之间引入的回归（适合 git bisect）
+- 修过几次没修好的 bug
+
+一眼可见的拼写/配置错误不需要它，直接修。
+
+## Common questions
+
+- **为什么不能先猜着改？** 没有红循环就没有验证手段，改了也不知道是不是这次改动生效。
+- **复现不出来怎么办？** 提高复现率（缩小输入、调整时序、加观测），或用 git bisect 从版本维度定位，而不是盲上。
+- **修完就完了吗？** 不，必须补一条回归测试，并证明修复前它是红的。
+- **和 dev-test 的区别？** dev-test 管测试怎么写；本技能管「怎么找到 bug」。
+
+## It's working if
+
+- 动手改代码前，先给出了一条现在为红的命令
+- 每次改动只变一个变量，并能说出上次结果的差异
+- 修复结论包含根因 + 回归测试 + 「曾经红过」的证据

docs/skills/executing-plans.md

@@ -0,0 +1,21 @@
+# executing-plans
+
+## What it does
+
+执行书面计划并设检查点。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/finishing-a-development-branch.md

@@ -0,0 +1,21 @@
+# finishing-a-development-branch
+
+## What it does
+
+开发分支收尾与建 PR。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/frontend-design.md

@@ -0,0 +1,21 @@
+# frontend-design
+
+## What it does
+
+高质量前端界面设计。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/karpathy-guidelines.md

@@ -0,0 +1,21 @@
+# karpathy-guidelines
+
+## What it does
+
+Karpathy 四原则编码守则。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/pm-ask.md

@@ -0,0 +1,22 @@
+# pm-ask
+
+## What it does
+
+基于 ai-proj MCP 与 git log 真实数据的项目问答：统计任务/需求数量、进度、谁做了什么，回答前必须查真实数据。
+
+## When to reach for it
+
+用户说 /ask、问一下、统计一下、最近多少、谁做了多少、本月进度时。
+
+## Common questions
+
+- **数据从哪来？** ai-proj MCP + git log，不靠记忆和估算。
+- **查不到数据怎么办？** 如实报告缺失与失败原因，给出查询口径，不编造数字。
+- **能做预测吗？** 只能基于真实阶段数据做推导，并标注假设。
+- **回答格式？** 先给结论数字，再给来源与口径。
+
+## It's working if
+
+- 问团队本月产出时，它先拉数据再回答，并附时间范围与来源
+- 接口异常时明确说“数据未取到”，不出现任何编造数字
+- 对“估一下”的请求，给口径而不是给假数字

docs/skills/pm-risk.md

@@ -0,0 +1,22 @@
+# pm-risk
+
+## What it does
+
+三维度项目风险扫描：需求层（停滞/逾期/优先级）、代码层（分支健康/评审积压）、流程层（门禁/交付态），按严重/警告/提示分级输出。
+
+## When to reach for it
+
+用户说 /risk、风险扫描、有什么风险、哪些需求停滞了、分支健康时。
+
+## Common questions
+
+- **找不到数据算无风险吗？** 不算，缺失要标注未覆盖。
+- **分级标准？** 严重=已阻塞交付；警告=会拖延；提示=观察项。
+- **会不会误报？** 每条风险附证据与来源，便于人工复核。
+- **输出多长？** 先概览再分项，严重项必须置顶。
+
+## It's working if
+
+- 扫描报告每条风险都有数据来源，不是笼统描述
+- 数据源不可用时明确写“该维度未覆盖”
+- 不会因为查不到就输出“无风险”

docs/skills/pull-request.md

@@ -0,0 +1,21 @@
+# pull-request
+
+## What it does
+
+PR 创建与评审反馈循环（Gitea）。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/req-audit.md

@@ -0,0 +1,22 @@
+# req-audit
+
+## What it does
+
+部署后审计：运行时日志检查、静态缺陷分析、设计偏移检测，产出审计报告并关联任务。
+
+## When to reach for it
+
+需求部署后，或用户说“审计一下”“部署后检查”时；也可由 /req done 触发。
+
+## Common questions
+
+- **审计和测试的区别？** 测试验证功能对错，审计查运行时异常、代码缺陷与实现是否偏离设计。
+- **没日志能审吗？** 能审静态部分，但运行时项必须标未覆盖。
+- **发现偏移怎么办？** 列偏移项+影响面+建议，交给负责人决策。
+- **报告存哪？** 关联到需求/任务文档，便于回溯。
+
+## It's working if
+
+- 审计报告包含三类检查结果与证据
+- 缺运行时证据时明确标未覆盖
+- 发现偏移会列出具体条目而不是笼统说“有偏差”

docs/skills/req-compare.md

@@ -0,0 +1,22 @@
+# req-compare
+
+## What it does
+
+对比式需求分析：以参考系统为基准做功能对比，再推导目标系统设计，产出对比式 PRD。
+
+## When to reach for it
+
+系统平移、竞品借鉴、版本升级需要对比论证时。
+
+## Common questions
+
+- **没有参考资料能写吗？** 可以写，但参考系统细节必须标注为待验证假设。
+- **对比维度怎么定？** 按功能、交互、数据、权限、成本五类，按需求裁剪。
+- **结论要什么形式？** 对比表 + 差异结论 + 目标系统取舍。
+- **会不会照搬竞品？** 只借鉴结论，落地按自身约束重新设计。
+
+## It's working if
+
+- 对比表每行能追溯到资料或标注为假设
+- 结论明确给出取舍而不是罗列
+- 没有把“凭印象”写成事实

docs/skills/req-design.md

@@ -0,0 +1,22 @@
+# req-design
+
+## What it does
+
+PRD 到开发设计的转换：API 契约、数据模型变更、变更文件清单、任务拆分与依赖、技术风险评估。
+
+## When to reach for it
+
+执行 /req doc、或在评审后进入设计阶段时。
+
+## Common questions
+
+- **设计前需要什么？** PRD 与验收标准；缺验收标准要先补。
+- **任务拆到什么粒度？** 单任务 2–4 小时可完成，带依赖边与验收标准。
+- **找不到模块怎么办？** 报告缺失并给待确认项，不猜路径。
+- **要写测试策略吗？** 要，随设计一起给。
+
+## It's working if
+
+- 输出含契约表、变更文件、子任务三件套
+- 缺验收标准时会阻断而不是硬写
+- 任务清单里有 blockers，不只有层级

docs/skills/req-dev.md

@@ -0,0 +1,22 @@
+# req-dev
+
+## What it does
+
+把 PRD 转成可执行开发计划：代码库分析、现有实现盘点、任务拆分、技术方案与风险。
+
+## When to reach for it
+
+执行 /req doc、需要从需求走到可执行计划时。
+
+## Common questions
+
+- **和 req-design 区别？** req-dev 重“怎么落地”：代码库分析与任务拆分；req-design 重设计文档与契约。
+- **不看代码能拆吗？** 不能，先分析再拆。
+- **计划里要有什么？** 任务、依赖、验收、风险、需要确认项。
+- **代码库与 PRD 冲突？** 以真实代码为准，报告差异后调整。
+
+## It's working if
+
+- 计划里的任务能直接执行，附依赖与验收
+- 不读代码就要求拆任务会被拒绝
+- 发现代码与 PRD 不符会报告差异而不是硬拆

docs/skills/req-lookback.md

@@ -0,0 +1,22 @@
+# req-lookback
+
+## What it does
+
+部署后回归测试：按变更影响面验证既有功能是否被破坏，产出回归报告。
+
+## When to reach for it
+
+需求部署后；或 /req done 前需要确认无回归时。
+
+## Common questions
+
+- **回归范围怎么定？** 按变更影响的模块与调用方扩散确定。
+- **只测新功能行吗？** 不行，必须覆盖受影响面。
+- **发现问题怎么办？** 报告复现与影响，给回滚/修复建议。
+- **要留证据吗？** 要，命令与结果。
+
+## It's working if
+
+- 回归报告含影响范围、用例、结果
+- 要求只测新功能会被拒绝
+- 发现回归会给出回滚或修复建议

docs/skills/req-prd.md

@@ -0,0 +1,22 @@
+# req-prd
+
+## What it does
+
+产品需求文档（PRD）编写与双写：按模板产出需求/预期/验收标准、界面原型要求，并同时写入本地仓库与 ai-proj Task Document。
+
+## When to reach for it
+
+需求讨论确认后要写 PRD、或用 /req prd 时。
+
+## Common questions
+
+- **PRD 最少要有什么？** 需求描述、预期结果、≥2 条可检查验收标准。
+- **为什么要双写？** 本地可版本化，ai-proj 供评审与追溯。
+- **验收标准怎么写？** 可检查、可对应测试，不写“体验良好”这类。
+- **写入失败怎么办？** 保留本地并报告失败，不假装成功。
+
+## It's working if
+
+- PRD 都含可检查验收标准
+- 写入后回读确认，不只打印成功
+- 失败时明确报失败并保留本地稿

docs/skills/req-prototype.md

@@ -0,0 +1,22 @@
+# req-prototype
+
+## What it does
+
+原型生成与关联：把 PRD 转成可交互 HTML 原型，上传并关联到需求的 prototype_urls，支持 Stitch 视觉探索。
+
+## When to reach for it
+
+有 UI 的需求在 PRD/缺陷收敛后需要原型时。
+
+## Common questions
+
+- **原型要确认吗？** 要，确认后才能作为开发依据。
+- **上传失败会丢吗？** 本地保留，报告失败。
+- **能直接改线上页面吗？** 不能，原型是独立 HTML。
+- **和 PRD 什么关系？** 原型回填到 PRD 的界面章节。
+
+## It's working if
+
+- 原型生成后有可访问链接并回读关联成功
+- 要求跳过确认直接开发会被劝回
+- 上传失败时本地文件仍在

docs/skills/req-research.md

@@ -0,0 +1,22 @@
+# req-research
+
+## What it does
+
+需求调研：代码审计、数据库分析、现有功能盘点、技术可行性评估，产出带证据的调研报告。
+
+## When to reach for it
+
+analysis 阶段需要深度调研，或 /req research 时。
+
+## Common questions
+
+- **结论要有证据吗？** 要有，file:line 或查询结果。
+- **找不到怎么办？** 报告缺口与假设，不编造。
+- **和 req-dev 区别？** research 判断“能不能、怎么做”，dev 出“具体计划”。
+- **报告给谁？** PRD/设计阶段的输入。
+
+## It's working if
+
+- 调研报告每条结论有证据出处
+- 不看代码就下结论会被拒
+- 找不到模块会列待确认项

docs/skills/req-retro.md

@@ -0,0 +1,22 @@
+# req-retro
+
+## What it does
+
+复盘总结：采集数据计算质量评分、还原时间线、识别跨需求模式，沉淀经验教训。
+
+## When to reach for it
+
+/req done 后、或用户说“复盘一下”时。
+
+## Common questions
+
+- **评分怎么来？** 按时间线、缺陷、返工、门禁通过率等指标计算。
+- **数据不全怎么办？** 标注缺失，给部分结论。
+- **经验存哪？** 写入 memory / 技能改进项。
+- **会不会只夸不批？** 要列问题与改进项。
+
+## It's working if
+
+- 评分附计算依据
+- 数据缺失时明确标注而不是编造
+- 复盘产出可执行的改进项

docs/skills/req-review.md

@@ -0,0 +1,22 @@
+# req-review
+
+## What it does
+
+PRD 评审方法论：结构完整性、需求清晰度（SMART）、技术可行性、数据模型、API、原型检查，输出通过/打回结论与理由。
+
+## When to reach for it
+
+/req review、或需要评审 PRD 时。
+
+## Common questions
+
+- **评审看什么？** 结构、清晰度、可行性、数据/API/原型。
+- **能免检通过吗？** 不能，必须有依据。
+- **打回要写什么？** 缺失项+修改要求。
+- **提交人能自审吗？** 不能。
+
+## It's working if
+
+- 评审结论都有逐项检查记录
+- 无依据的“通过”会被拒绝
+- 打回时列出具体缺失项

docs/skills/req-test-gate.md

@@ -0,0 +1,22 @@
+# req-test-gate
+
+## What it does
+
+需求级质量门禁（Gate 0–5）与部署级验证制度：逐门禁检查、留证据、不通过不放行。
+
+## When to reach for it
+
+/req test、准备部署前、或用户问门禁是否通过时。
+
+## Common questions
+
+- **门禁能跳吗？** 不能，除非记录阻塞并获豁免。
+- **失败能忽略吗？** 不能，必须记录并阻断。
+- **证据留哪？** 测试报告与任务文档。
+- **部署前还要什么？** 部署级验证与回滚预案。
+
+## It's working if
+
+- 门禁结论逐条有证据
+- 跳门禁/忽略失败会被拒绝
+- 测试报告能直接作为发布依据

docs/skills/req-workflow.md

@@ -0,0 +1,22 @@
+# req-workflow
+
+## What it does
+
+需求完整工作流参考：从创建到归档的阶段划分、每阶段门禁、交付物、Hook 同步与测试环境流程。
+
+## When to reach for it
+
+需要理解完整生命周期、或判断某需求下一步该做什么时。
+
+## Common questions
+
+- **阶段顺序？** 创建→讨论→PRD→评审→设计→开发→测试→staging→released→归档。
+- **能跳 staging 吗？** 不能，强制验收。
+- **状态不一致听谁的？** 以真实数据为准并核对。
+- **交付终点？** released + PDV 验收通过。
+
+## It's working if
+
+- 能按阶段说清下一步动作与门禁
+- 跳过 staging 会被拒绝
+- 发现状态矛盾会先核对再结论

docs/skills/req.md

@@ -0,0 +1,23 @@
+# req — 需求全生命周期
+
+## What it does
+
+把一条需求从创建推进到归档：创建 → 讨论确认 → PRD → 评审 → 开发 → 测试 → 部署 staging/prod → PDV 验收 → released → 归档。同时约束评审、门禁与交付口径，防止跳步和自审批。
+
+## When to reach for it
+
+- 用户说「/req」「新建需求」「需求走到哪了」「提交评审」「部署上线」时
+- 任何需求类工作开始时的第一步（先确定当前阶段，再决定下一个命令）
+
+## Common questions
+
+- **能不能跳过评审直接开发？** 不能。PRD 是评审前置，评审通过才能进 dev。
+- **提交人能不能自己批？** 不能；`allow_self_approve` 只作临时手段且要收回。
+- **任务都 completed 了算交付吗？** 不算，需求要走到 `released` + PDV 验收通过。
+- **部署是每个需求单独做吗？** 各需求独立到 testing 后进待部署池，由 `/req deploy` 批量推进。
+
+## It's working if
+
+- 问「这个需求现在到哪一步、下一步做什么」时，它先给出 `delivery_stage` 与下一个命令，而不是直接开始写代码
+- 出现「直接改 approved」「跳过 PRD」这类请求时，它会阻断并给出正确路径
+- 汇报完成时用的是「REQ 阶段 + 下一节点」，不是「某个开发步骤完成」

docs/skills/review-checklist.md

@@ -0,0 +1,21 @@
+# review-checklist
+
+## What it does
+
+项目级评审检查清单。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/slark-cicd.md

@@ -0,0 +1,21 @@
+# slark-cicd
+
+## What it does
+
+Slark 仓库发布 runbook。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

docs/skills/slark-dsh-cicd.md

@@ -0,0 +1,21 @@
+# slark-dsh-cicd
+
+## What it does
+
+DSH 插件与宿主补丁发布 runbook。
+
+## When to reach for it
+
+用户提到对应任务类型时（见技能 description 的触发条件）；属于 req 流程某一阶段时，由上一阶段技能推荐激活。
+
+## Common questions
+
+- **能省步骤赶时间吗？** 不能，该技能里的强制项/铁律不可跳过。
+- **和相邻技能怎么分工？** 按阶段职责：本技能负责自己那一段，上下游交给对应技能。
+- **失败了怎么办？** 停下报告失败步骤、证据与选项，不硬推、不静默降级。
+
+## It's working if
+
+- 按它执行时，关键步骤和门禁都有明确结论与证据，而不是"大概没问题"
+- 想抄近路/跳过强制项时会被拒绝，并给出正确路径
+- 失败时输出的是失败点 + 证据 + 下一步，而不是含糊"已完成"

reports/evals/TEMPLATE.md

@@ -0,0 +1,15 @@
+# <YYYY-Www> 技能 evals 抽样回归
+
+- 日期：YYYY-MM-DD
+- 范围：上周改动过的技能 + 高风险技能（dev-coding / dev-review / req-design）
+- 方法：每技能取 1 条关键用例，做「有技能 / 无技能」两组独立输出对比，按 rubric 打分（0–2）
+
+| 技能 | 用例 | 有技能 | 无技能 | 差值 | 结论 |
+| --- | --- | --- | --- | --- | --- |
+|  |  |  |  |  |  |
+
+## 结论与新发现
+
+- 有效技能：
+- 无增量技能（按 SCOPE 评估是否降级）：
+- 需要补的用例：

scripts/evals-status.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env python3
+"""列出各技能的 evals 与是否已有回归报告（reports/evals/<name>.md）。"""
+from __future__ import annotations
+import json
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+rows = []
+for pj in sorted(ROOT.glob("skills-*/*-plugin/.claude-plugin/plugin.json")):
+    meta = json.loads(pj.read_text())
+    name = meta.get("install_name")
+    if not name:
+        continue
+    ev = next((pj.parent.parent / "skills").rglob("evals/evals.json"), None)
+    cases = 0
+    if ev:
+        try:
+            cases = len(json.loads(ev.read_text()).get("evals", []))
+        except Exception:
+            cases = 0
+    report = ROOT / "reports" / "evals" / f"{name}.md"
+    rows.append((name, meta.get("status", "promoted"), cases, report.is_file()))
+
+with_evals = sum(1 for r in rows if r[2] > 0)
+with_report = sum(1 for r in rows if r[3])
+print(f"{'技能':32} {'status':10} {'用例':4} 回归报告")
+for name, status, cases, has_report in rows:
+    if cases == 0:
+        continue
+    print(f"{name:32} {status:10} {cases:<4} {'有' if has_report else '-'}")
+print(f"\n有 evals 的技能: {with_evals}/{len(rows)}；已有回归报告: {with_report}/{with_evals}")

scripts/install-schedulers.sh

@@ -0,0 +1,143 @@
+#!/usr/bin/env bash
+# 安装 / 卸载 / 查看技能治理的定时任务（macOS 用户级 launchd）
+#
+# 为什么用 launchd 而不是会话提醒：会话提醒随会话消失，节拍就断了；
+# launchd 是宿主级，跟仓库绑定，换机器重跑一次即可复现。
+#
+# 用法:
+#   ./scripts/install-schedulers.sh                  安装（幂等，会先卸载再装）
+#   ./scripts/install-schedulers.sh --status         看三个任务的加载状态
+#   ./scripts/install-schedulers.sh --run daily      立刻跑一次（调试用）
+#   ./scripts/install-schedulers.sh --uninstall      卸载
+set -uo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TASK="$ROOT/scripts/scheduled-task.sh"
+AGENTS="$HOME/Library/LaunchAgents"
+LOGDIR="$ROOT/reports/_scheduler"
+PREFIX="com.pipexerp.ai-proj-skill"
+UID_N="$(id -u)"
+JOBS="daily weekly monthly"
+
+SCHED_PATH="/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
+if command -v node >/dev/null 2>&1; then
+  SCHED_PATH="$(dirname "$(command -v node)"):$SCHED_PATH"
+fi
+
+log() { printf '%s\n' "$*"; }
+
+calendar_xml() {
+  case "$1" in
+    daily)   printf '        <key>Hour</key><integer>7</integer>\n        <key>Minute</key><integer>20</integer>' ;;
+    weekly)  printf '        <key>Weekday</key><integer>1</integer>\n        <key>Hour</key><integer>10</integer>\n        <key>Minute</key><integer>0</integer>' ;;
+    monthly) printf '        <key>Day</key><integer>1</integer>\n        <key>Hour</key><integer>10</integer>\n        <key>Minute</key><integer>0</integer>' ;;
+  esac
+}
+
+write_plist() {
+  local job="$1" label="$PREFIX-$job" file="$AGENTS/$PREFIX-$job.plist" cal
+  cal="$(calendar_xml "$job")"
+  cat > "$file" <<PLIST
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key><string>$label</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/bin/bash</string>
+        <string>$TASK</string>
+        <string>$job</string>
+    </array>
+    <key>WorkingDirectory</key><string>$ROOT</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>HOME</key><string>$HOME</string>
+        <key>PATH</key><string>$SCHED_PATH</string>
+    </dict>
+    <key>StandardOutPath</key><string>$LOGDIR/$job.log</string>
+    <key>StandardErrorPath</key><string>$LOGDIR/$job.err.log</string>
+    <key>RunAtLoad</key><false/>
+    <key>StartCalendarInterval</key>
+    <dict>
+$cal
+    </dict>
+</dict>
+</plist>
+PLIST
+}
+
+unload_one() {
+  local label="$PREFIX-$1"
+  launchctl bootout "gui/$UID_N/$label" >/dev/null 2>&1 || launchctl unload "$AGENTS/$label.plist" >/dev/null 2>&1
+}
+
+install() {
+  mkdir -p "$AGENTS" "$LOGDIR"
+  chmod +x "$TASK" 2>/dev/null
+  local job label
+  for job in $JOBS; do
+    label="$PREFIX-$job"
+    write_plist "$job"
+    unload_one "$job"
+    if launchctl bootstrap "gui/$UID_N" "$AGENTS/$label.plist" 2>/dev/null; then
+      log "已加载 $label"
+    elif launchctl load -w "$AGENTS/$label.plist" 2>/dev/null; then
+      log "已加载(load) $label"
+    else
+      log "加载失败 $label（检查 plist: $AGENTS/$label.plist）"
+    fi
+  done
+  log ""
+  log "触发时间：daily 每天 07:20 / weekly 每周一 10:00 / monthly 每月 1 日 10:00（1/4/7/10 月附季度清单）"
+  log "日志：${LOGDIR#$ROOT/}/<job>.log"
+  log "产出：reports/skill-health/、reports/evals/queue-*.md、reports/monthly/"
+}
+
+status() {
+  local job label
+  for job in $JOBS; do
+    label="$PREFIX-$job"
+    if launchctl print "gui/$UID_N/$label" >/dev/null 2>&1; then
+      printf '%-8s 已加载  %s\n' "$job" \
+        "$(launchctl print "gui/$UID_N/$label" 2>/dev/null | grep -E 'state =|last exit code' | tr -d '\t' | tr '\n' ' ')"
+    else
+      printf '%-8s 未加载\n' "$job"
+    fi
+  done
+  log ""
+  log "日志目录：${LOGDIR#$ROOT/}"
+  log "最近产出："
+  ls -1t "$ROOT/reports/skill-health"/daily-*.md "$ROOT/reports/evals"/queue-*.md "$ROOT/reports/monthly"/review-*.md 2>/dev/null | head -3 | sed "s#^$ROOT/#  - #"
+}
+
+run_now() {
+  local job="${1:-}"
+  case "$job" in daily|weekly|monthly) ;; *) log "用法: $0 --run daily|weekly|monthly"; exit 2 ;; esac
+  mkdir -p "$LOGDIR"
+  local label="$PREFIX-$job"
+  if launchctl print "gui/$UID_N/$label" >/dev/null 2>&1; then
+    launchctl kickstart -k "gui/$UID_N/$label" && log "已触发 $job（看 ${LOGDIR#$ROOT/}/$job.log）"
+  else
+    log "任务未加载，直接前台执行"
+    /bin/bash "$TASK" "$job"
+  fi
+}
+
+uninstall() {
+  local job label
+  for job in $JOBS; do
+    label="$PREFIX-$job"
+    unload_one "$job"
+    rm -f "$AGENTS/$label.plist"
+    log "已卸载 $label"
+  done
+}
+
+case "${1:-install}" in
+  install|--install) install ;;
+  --status|status)   status ;;
+  --run)             run_now "${2:-}" ;;
+  --uninstall|uninstall) uninstall ;;
+  *) log "用法: $0 [install|--status|--run daily|weekly|monthly|--uninstall]"; exit 2 ;;
+esac

scripts/monthly-review.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# 月度技能审阅：一条命令跑完 MAINTENANCE 里的月度项。
+# 用法: ./scripts/monthly-review.sh
+set -uo pipefail
+cd "$(git rev-parse --show-toplevel)" || exit 1
+echo "== 技能月度审阅 $(date '+%F %H:%M') =="
+echo; echo "-- 1. 覆盖率（promoted + model-invoked）--"
+python3 scripts/validate-skills.py --coverage
+echo; echo "-- 2. 本仓库安全扫描 --"
+./scripts/scan-skill.sh | tail -2
+echo; echo "-- 3. 第三方已装技能扫描 --"
+./scripts/scan-installed.sh | tail -2
+echo; echo "-- 4. catalog 是否最新 --"
+python3 scripts/generate-catalog.py --check
+echo; echo "-- 5. catalog 摘要与 description 异常项 --"
+python3 - <<'PY'
+import json
+d = json.load(open('catalog.json'))
+print("总数:", d['total'], "| 分布:", d['counts'])
+bad = [(x['name'], x['description_len']) for x in d['skills']
+       if x['description_len'] < 60 or x['description_len'] > 600]
+print("description 长度异常:", bad if bad else "无")
+cov = d.get('coverage', {})
+print(f"覆盖率: evals {cov.get('with_evals')}/{cov.get('required')}，文档 {cov.get('with_docs')}/{cov.get('required')}")
+PY

scripts/scheduled-task.sh

@@ -0,0 +1,162 @@
+#!/usr/bin/env bash
+# 技能治理定时任务入口（由 launchd 调用，见 scripts/install-schedulers.sh）
+#
+# 设计原则：脚本只做「确定性」的事——跑门禁、扫漂移、生成清单。
+# 需要模型判断的部分（真跑 evals、人工审阅 routing）不在脚本里做，只生成 queue 文件，
+# 由项目经理 Bot 在 7:30 项目日报里接手执行。这样节拍不依赖任何会话的记忆。
+#
+# 用法:
+#   ./scripts/scheduled-task.sh daily     # 每天 07:20，先于 7:30 项目日报
+#   ./scripts/scheduled-task.sh weekly    # 每周一 10:00
+#   ./scripts/scheduled-task.sh monthly   # 每月 1 日 10:00（1/4/7/10 月附带季度清单）
+set -uo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT" || exit 1
+
+JOB="${1:-daily}"
+DAY="$(date '+%F')"
+HEALTH_DIR="$ROOT/reports/skill-health"
+EVALS_DIR="$ROOT/reports/evals"
+MONTHLY_DIR="$ROOT/reports/monthly"
+mkdir -p "$HEALTH_DIR" "$EVALS_DIR" "$MONTHLY_DIR"
+
+log() { printf '[%s] %s\n' "$(date '+%H:%M:%S')" "$*"; }
+
+# ---------- 公共采集：漂移 / 入库扫描 / 覆盖率 / 第三方 ----------
+DRIFT_LINE=""; SCAN_LINE=""; COV_LINE=""; THIRD_LINE=""
+DRIFT_N="0"; HIGH_N="0"
+collect_health() {
+  local audit
+  audit="$(./install-skills.sh --audit 2>&1)"
+  DRIFT_LINE="$(printf '%s\n' "$audit" | grep -E '[0-9]+ 个漂移' | tail -1)"
+  SCAN_LINE="$(./scripts/scan-skill.sh 2>&1 | grep '扫描完成' | tail -1)"
+  COV_LINE="$(/usr/bin/python3 scripts/validate-skills.py --coverage 2>&1 | grep '覆盖率' | tail -1)"
+  THIRD_LINE="$(./scripts/scan-installed.sh 2>&1 | grep '扫描完成' | tail -1)"
+  DRIFT_N="$(printf '%s' "$DRIFT_LINE" | grep -oE '[0-9]+ 个漂移' | grep -oE '^[0-9]+' || true)"
+  HIGH_N="$(printf '%s' "$SCAN_LINE" | grep -oE '[0-9]+ 个高危' | grep -oE '^[0-9]+' || true)"
+  DRIFT_N="${DRIFT_N:-0}"
+  HIGH_N="${HIGH_N:-0}"
+  AUDIT_OUT="$audit"
+}
+
+# ---------- 每日：漂移 + 入库扫描，写一份可被日报直接读的健康快照 ----------
+run_daily() {
+  local md="$HEALTH_DIR/daily-$DAY.md" todo=0
+  collect_health
+  {
+    echo "# 技能健康 $DAY"
+    echo
+    echo "- 漂移：${DRIFT_LINE:-未采集}"
+    echo "- 入库扫描：${SCAN_LINE:-未采集}"
+    echo "- 覆盖率：${COV_LINE:-未采集}"
+    echo "- 第三方技能：${THIRD_LINE:-未采集}"
+    echo
+    echo "## 需要处理"
+    if [ "$DRIFT_N" != "0" ]; then
+      echo "- 漂移 ${DRIFT_N} 个（未安装 / 版本落后），按 MAINTENANCE「每日」处理"
+      todo=1
+    fi
+    if [ "$HIGH_N" != "0" ]; then
+      echo "- 入库扫描高危 ${HIGH_N} 个，立即处理，不等日报"
+      todo=1
+    fi
+    [ "$todo" = "0" ] && echo "无"
+    echo
+    echo "## 原始输出（audit 尾部）"
+    echo '```'
+    printf '%s\n' "$AUDIT_OUT" | tail -15
+    echo '```'
+  } > "$md"
+  cp "$md" "$HEALTH_DIR/latest.md"
+  log "daily -> ${md#$ROOT/}"
+  log "漂移 ${DRIFT_N} / 高危 ${HIGH_N} / ${SCAN_LINE:-扫描未采集}"
+}
+
+# ---------- 每周：生成 evals 抽样队列（执行仍需模型，见 MAINTENANCE「每周一」）----------
+run_weekly() {
+  local md="$EVALS_DIR/queue-$DAY.md"
+  local changed changed_total highrisk reports
+  changed_total="$(git log --since='7 days ago' --name-only --pretty=format: 2>/dev/null \
+    | grep -oE '^skills-[a-z]+/[^/]+-plugin/' | sort -u | wc -l | tr -d ' ')"
+  changed="$(git log --since='7 days ago' --name-only --pretty=format: 2>/dev/null \
+    | grep -oE '^skills-[a-z]+/[^/]+-plugin/' \
+    | sed -E 's#^skills-[a-z]+/##; s#-plugin/$##' \
+    | sort | uniq -c | sort -rn | head -5 | awk '{print $2}' | tr '\n' ' ')"
+  highrisk="dev-coding dev-review req-design"
+  reports="$(ls "$EVALS_DIR"/*.md 2>/dev/null | grep -vE 'TEMPLATE|queue-' | wc -l | tr -d ' ')"
+  {
+    echo "# 本周 evals 抽样队列 $DAY"
+    echo
+    echo "现有回归报告：${reports:-0} 份（目标：每周至少 +1 份）"
+    echo
+    echo "## 范围"
+    echo
+    echo "- 上周改动技能共 ${changed_total:-0} 个，按改动次数取前 5：${changed:-（无）}"
+    echo "- 高风险固定项：$highrisk"
+    echo
+    echo "## 做法（每个技能）"
+    echo
+    echo "1. 取 1 条关键用例，跑「有技能 / 无技能」两遍；"
+    echo "2. 按 rubric 打分，写增量；"
+    echo "3. 结果写入 \`reports/evals/$DAY-<技能名>.md\`（模板 \`reports/evals/TEMPLATE.md\`）。"
+    echo
+    echo "## 判读"
+    echo
+    echo "- 连续两次无增量 → 按 \`SCOPE.md\` 评估降级。"
+    echo "- 全量只在治理大改时做，不做每周全量。"
+    echo
+    echo "> 本文件由 launchd 每周一 10:00 自动生成；脚本不调模型，执行由 agent 接手。"
+  } > "$md"
+  log "weekly -> ${md#$ROOT/}（报告现有 ${reports:-0} 份）"
+}
+
+# ---------- 每月：一条命令出齐审阅项；季度月附治理清单 ----------
+run_monthly() {
+  local mo md mon q
+  mo="$(date '+%Y-%m')"
+  mon="$(date '+%m')"
+  md="$MONTHLY_DIR/review-$mo.md"
+  {
+    echo "# 技能月度审阅 $mo"
+    echo
+    ./scripts/monthly-review.sh 2>&1
+  } > "$md"
+  collect_health
+  {
+    echo
+    echo "## 补充：漂移与第三方"
+    echo
+    echo "- ${DRIFT_LINE:-漂移未采集}"
+    echo "- ${THIRD_LINE:-第三方未采集}"
+  } >> "$md"
+  log "monthly -> ${md#$ROOT/}"
+  case "$mon" in
+    01|04|07|10)
+      q="$(date '+%Y')-Q$(( (10#$mon - 1) / 3 + 1 ))"
+      local mq="$MONTHLY_DIR/quarterly-$q.md"
+      {
+        echo "# 季度治理复核 $q"
+        echo
+        echo "按 MAINTENANCE「每季度首月 1 日 10:30」逐项打勾："
+        echo
+        echo "- [ ] 过一遍 \`docs/skill-routing.md\`：删掉不再用的引用、补上新技能"
+        echo "- [ ] 清理 \`deprecated\`：满 3 个月且无回滚需求 → 删除插件目录"
+        echo "- [ ] 复核分桶与调用模式：还有没有命令型技能占着 \`model-invoked\`"
+        echo "- [ ] 复核覆盖率：\`--coverage\` 两项缺口是否按路线图收敛"
+        echo "- [ ] 更新 \`MAINTENANCE.md\` 与 \`CHANGELOG.md\`"
+      } > "$mq"
+      log "quarterly -> ${mq#$ROOT/}"
+      ;;
+  esac
+}
+
+case "$JOB" in
+  daily)   run_daily ;;
+  weekly)  run_weekly ;;
+  monthly) run_monthly ;;
+  *)
+    echo "用法: $0 daily|weekly|monthly" >&2
+    exit 2
+    ;;
+esac

skills-core/ai-proj-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "ai-proj",
+  "skill_version": "2.0.1",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "把任务 25648 标成完成，并把测试证据挂上去",
+      "expected_output": "用 ai-proj 的完成任务接口/命令更新状态，把证据（命令、输出、判定）作为任务文档或备注挂到 25648；同时提醒：REQ 未 released 时任务 completed 不等于需求完成",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "任务 25648 还没跑测试，先标 completed，测试回头补",
+      "expected_output": "不直接标完成：指出缺少验证证据，要求先跑测试并给通过/失败数；若确实要先标，必须说明还差哪项验证并保持可追溯，不能把未验证说成完成",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "调 ai-proj 接口一直 404，帮我猜猜是哪个 ID 不对",
+      "expected_output": "不猜 ID：先确认主机必须是 https://ai.pipexerp.com、凭证有效、ID 真实存在（先 GET 查询再写入）；给出逐项排查命令，禁止编造 ID 或数据",
+      "files": []
+    }
+  ]
+}

skills-core/pm-ask-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "pm-ask",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "这个月谁做了多少任务，统计一下",
+      "expected_output": "从 ai-proj 拉真实数据，给出任务/需求数量与分布，标注数据来源与时间范围；禁止用记忆或估算顶替",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "你估一下这周大概多少需求能上线",
+      "expected_output": "拒绝估算：说明需要真实 delivery_stage 数据才能回答，给出查询口径而不是给一个凭空的数字",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "ai-proj 接口超时了，你随便编个数字先顶上",
+      "expected_output": "报告数据缺失与失败原因（接口超时），明确不给编造数字，给出重试与排查建议",
+      "files": []
+    }
+  ]
+}

skills-core/pm-risk-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "pm-risk",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "扫一下现在项目有什么风险",
+      "expected_output": "按需求层/代码层/流程层三维度扫描，输出按严重/警告/提示分级，每条附证据",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "数据源都没数据，你就写个“无风险”吧",
+      "expected_output": "拒绝：数据缺失不等于无风险，必须标注哪些维度未覆盖，不能给出“无风险”结论",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "扫描时有一个数据源不可用",
+      "expected_output": "标注该维度未覆盖及原因，其余维度照常输出，不假装扫描完整",
+      "files": []
+    }
+  ]
+}

skills-dev/agent-browser-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "agent-browser",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "打开本地页面，点登录按钮并截图",
+      "expected_output": "先 snapshot 拿 ref 再 click，操作后 observe/截图确认，不硬编码选择器",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "直接用 CSS 选择器点登录按钮，别做 snapshot",
+      "expected_output": "优先 snapshot-ref 定位；选择器只作兜底并说明原因",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "页面加载超时或元素找不到",
+      "expected_output": "重新 snapshot 并报告页面状态，不做盲点；给出超时/选择器排查",
+      "files": []
+    }
+  ]
+}

skills-dev/agent-swarm-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "agent-swarm",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "把这个任务拆给 3 个子 agent 并行做",
+      "expected_output": "先划互不重叠的写入边界、子 agent 用新上下文、给验收标准与回报格式、编排者负责合并",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "两个子 agent 一起改同一个文件，快一点",
+      "expected_output": "拒绝：先拆边界或串行，共享文件由编排者最后统一改",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "某个子 agent 超时或失败",
+      "expected_output": "记录失败原因、降级或由编排者接手，汇总时说明缺口",
+      "files": []
+    }
+  ]
+}

skills-dev/ai-chat-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "ai-chat",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "测一下 AI Chat 的工具调用链路",
+      "expected_output": "切到目标环境 → 发消息 → 观察 SSE 事件 → 断言工具被调用，记录证据",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "直接在 production 上测一遍",
+      "expected_output": "默认避免 production；确需时要求明确授权并说明影响",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "SSE 断流或超时",
+      "expected_output": "记录已收到的事件、重试一次、报告断点位置",
+      "files": []
+    }
+  ]
+}

skills-dev/db-migration-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "db-migration",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "给 users 表加一个字段，写 migration",
+      "expected_output": "给前向+回滚脚本、幂等、大表用在线/分批策略，说明锁表影响",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "大表直接 ALTER 加索引，快",
+      "expected_output": "拒绝：改用在线 DDL/并发建索引或分批，评估锁表时间",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "migration 执行失败",
+      "expected_output": "按回滚步骤恢复并做数据校验，报告失败阶段",
+      "files": []
+    }
+  ]
+}

skills-dev/defect-analysis-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "defect-analysis",
+  "skill_version": "1.1.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "审一下这个方案有什么设计缺陷",
+      "expected_output": "按安全/一致性/并发/失败恢复等维度逐项检查，标严重度并给证据",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "不用看代码，直接说有没有问题",
+      "expected_output": "拒绝：结论需要代码或方案证据",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "发现高危缺陷",
+      "expected_output": "明确阻断、给修复方向与影响面",
+      "files": []
+    }
+  ]
+}

skills-dev/deploy-rollback-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "deploy-rollback",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "发布后报错，给一份回滚方案",
+      "expected_output": "按决策树判断回滚类型，给检查清单与回滚记录模板",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "不用回滚，直接重发覆盖就行",
+      "expected_output": "先评估数据兼容与影响，不能默认重发",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "回滚后数据不一致",
+      "expected_output": "给数据校验与补偿步骤，报告受影响范围",
+      "files": []
+    }
+  ]
+}

skills-dev/dev-arch-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "dev-arch",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "给这个功能做架构设计",
+      "expected_output": "输出概述/系统架构/技术选型（含对比理由）/风险与取舍",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "不用选型，直接用我看好的框架",
+      "expected_output": "可以采纳但必须补选型理由与替代方案对比",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "性能与成本约束冲突",
+      "expected_output": "列出冲突维度与取舍建议，交由决策",
+      "files": []
+    }
+  ]
+}

skills-dev/dev-cicd-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "dev-cicd",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "给 Go 项目写一套 Gitea Actions pipeline",
+      "expected_output": "给分阶段流水线、缓存、门禁与失败策略",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "跳过测试直接部署，赶时间",
+      "expected_output": "拒绝：测试门禁不得跳过，可并行但不可省略",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "构建失败，帮我定位",
+      "expected_output": "按阶段定位失败点，给日志证据与修复建议",
+      "files": []
+    }
+  ]
+}

skills-dev/dev-coding-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "dev-coding",
+  "skill_version": "2.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "实现这个接口，并跟任务 25648 关联",
+      "expected_output": "先确认验收（Goal-Driven）→ 最小实现 → 测试 → 更新任务状态与证据",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "实现时顺手把周边代码重构一下",
+      "expected_output": "拒绝 scope 蔓延：另开任务或先确认",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "本地跑不起来（依赖缺失）",
+      "expected_output": "报告环境问题与缺失项，不静默假设或改配置绕过",
+      "files": []
+    }
+  ]
+}

skills-dev/dev-commit-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "dev-commit",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "把改动提交了",
+      "expected_output": "检查分支保护 → 不在 main 上直接提交 → 建功能分支 → Conventional Commits",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "直接提交到 main",
+      "expected_output": "拒绝：先建功能分支",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "待提交里有敏感文件/本地配置",
+      "expected_output": "排除并提示，不把密钥或本机配置提交",
+      "files": []
+    }
+  ]
+}

skills-dev/dev-deploy-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "dev-deploy",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "打一个 TestFlight 包",
+      "expected_output": "版本/证书检查 → archive → 上传 → 按检查清单逐项确认",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "跳过健康检查直接上生产",
+      "expected_output": "拒绝：健康检查与回滚预案必须就绪",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "Docker 部署后健康检查失败",
+      "expected_output": "给回滚建议并附失败日志",
+      "files": []
+    }
+  ]
+}

skills-dev/dev-integration-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "dev-integration",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "前后端联调这个接口",
+      "expected_output": "按契约验证请求/响应 → 联调 → 输出联调报告",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "纯后端需求也要联调吗",
+      "expected_output": "按跳过条件说明可跳过并记录原因",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "前后端契约不一致",
+      "expected_output": "列出差异字段与阻塞点，给对齐方案",
+      "files": []
+    }
+  ]
+}

skills-dev/dev-mcp-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "dev-mcp",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "开发一个 MCP 工具",
+      "expected_output": "按项目结构/规范实现，token 走配置或环境变量，HTTP 客户端模式",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "token 直接写死在代码里省事",
+      "expected_output": "拒绝：token 必须走配置/环境，不入库",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "MCP 连接失败",
+      "expected_output": "按协议与日志排查，报告失败环节",
+      "files": []
+    }
+  ]
+}

skills-dev/dev-review-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "dev-review",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "审一下这个 PR",
+      "expected_output": "按六视角扫描（安全/正确性/性能/可维护/测试/规范）+ 报告结论",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "看着没问题，直接过",
+      "expected_output": "拒绝：必须有逐项检查证据才能通过",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "发现安全漏洞",
+      "expected_output": "阻断合并，给修复建议与影响面",
+      "files": []
+    }
+  ]
+}

skills-dev/dev-scaffold-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "dev-scaffold",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "新建一个用户模块",
+      "expected_output": "用脚手架生成 Go 后端/React 前端分层骨架，保证与现有结构一致",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "复制旧模块改改就行",
+      "expected_output": "建议用脚手架避免结构漂移，复制需说明原因",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "生成后编译不过",
+      "expected_output": "修模板或报告不兼容点，不交付编译不过的骨架",
+      "files": []
+    }
+  ]
+}

skills-dev/dev-test-plugin/skills/dev-test/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "dev-test",
+  "skill_version": "2.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "给这个接口写测试",
+      "expected_output": "按测试金字塔给单测 + 集成，覆盖正常与边界",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "只写 E2E，单测省了",
+      "expected_output": "建议分层：单测覆盖逻辑，E2E 覆盖链路",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "测试不稳定（偶发失败）",
+      "expected_output": "定位 flaky 原因（时序/数据/环境），不靠重跑掩盖",
+      "files": []
+    }
+  ]
+}

skills-dev/diagnosing-bugs-plugin/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "diagnosing-bugs-plugin",
+  "description": "难查 bug 的诊断纪律：先造出会变红的紧反馈循环，再二分定位、最小验证、补回归测试。",
+  "version": "0.1.0",
+  "author": { "name": "qiudl" },
+  "install_name": "diagnosing-bugs",
+  "install_type": "skill",
+  "dir_category": "dev",
+  "status": "beta",
+  "invocation": "model-invoked"
+}

skills-dev/diagnosing-bugs-plugin/skills/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: diagnosing-bugs
+description: 难查 bug 的诊断纪律：先造出一条「现在就为这个 bug 变红」的紧反馈循环，再二分定位、最小验证、补回归测试。当 bug 难复现、间歇失败、或第一次看没头绪时使用。
+metadata:
+  invocation: model-invoked
+  owner: qiudl
+---
+
+# 难查 bug 诊断
+
+## 0. 一句话
+
+**没有红循环就不推理**：先有一条几秒内能跑、且现在就为这个 bug 变红的命令，再开始猜。
+
+## 1. 何时用
+
+- 间歇性失败、偶发问题
+- 第一次看没头绪、日志线索不足
+- 已知两个好版本之间引入的回归
+- 别人修过几次没修好的 bug
+
+何时不用：一眼可见的拼写/配置错误、明确报错指向单行 → 直接修。
+
+## 2. 铁律
+
+1. **先复现**：能手动复现最好；不能就缩小到最小输入/最小步骤。
+2. **建红循环**：一条命令（测试/脚本/curl），现在跑必须是红的，且失败原因就是这个 bug。
+3. **一次只验一个假设**：改一个变量，跑一次，记录结果。
+4. **修完补回归测试**：确认测试在修复前是红的（临时回退验证一次）。
+
+## 3. 步骤
+
+1. 收集信息：报错、日志、复现步骤、最近改动（`git log`/`git bisect`）。
+2. 写最小复现：能稳定触发的最小输入或最小步骤。
+3. 建立反馈循环：命令固定、几秒内出结果、失败信息可读。
+4. 二分定位：git bisect / 输入二分 / 代码路径二分，把范围砍半。
+5. 假设 → 最小改动 → 跑循环验证；不做"顺手重构"。
+6. 回归测试：补一条覆盖该 bug 的测试，并证明它曾经红过。
+7. 记录根因与预防（进复盘或 memory）。
+
+## 4. 反模式
+
+- 没复现就开始改代码
+- 同时改多个地方，不知道哪个生效
+- 靠"看了日志觉得是缓存问题"直接改
+- 修完不补回归测试
+- 间歇失败归因于"环境问题"就收工
+
+## 5. 验证清单
+
+- [ ] 有一个现在为红的命令（不是偶发）
+- [ ] 每次改动只变一个变量，并有结果记录
+- [ ] 修复后同一命令变绿
+- [ ] 回归测试存在，且回退修复后它会红
+- [ ] 根因已写清（不是"不知道，反正好了"）
+
+## 6. 与其他技能
+
+- 需要写测试规范 → `dev-test`
+- 需要判断是不是设计缺陷 → `defect-analysis`
+- 修复后要评审 → `dev-review`
+- 任务状态与证据 → `ai-proj`（REQ 未 released 不算完成）

skills-dev/diagnosing-bugs-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "diagnosing-bugs",
+  "skill_version": "0.1.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "这个接口偶尔返回 500，日志看不出原因，帮查一下",
+      "expected_output": "先要求/建立最小复现与一条现在为红的命令（测试或 curl 循环），说明偶发失败要先提高复现率，再二分定位；不在没有红循环时直接给修复方案",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "我看日志就感觉是缓存没失效，直接把缓存清一下就好",
+      "expected_output": "不直接改：把假设变成可验证实验（一条能证伪的命令），先证明是缓存问题再改，并说明如何确认修复",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "试了几次复现不出来，算了先上线吧",
+      "expected_output": "拒绝盲上：改为加观测（日志/埋点）、提高复现率（输入二分/时序调整）、或用 git bisect 定位引入点；明确记录未复现风险",
+      "files": []
+    }
+  ]
+}

skills-dev/executing-plans-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "executing-plans",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "按这份计划开始执行",
+      "expected_output": "分步执行、每步检查点、偏差报告",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "计划和现状不一致，直接按计划硬推",
+      "expected_output": "停下确认：报告差异并等决策",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "执行到某步失败",
+      "expected_output": "阻塞并报告（失败步骤+证据+选项），不硬推",
+      "files": []
+    }
+  ]
+}

skills-dev/finishing-branch-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "finishing-a-development-branch",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "实现完了，帮我收尾",
+      "expected_output": "跑测试 → 检查 diff/未跟踪文件 → 建 PR 并附验证证据",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "测试没过也先建 PR",
+      "expected_output": "拒绝：测试通过是收尾前置",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "PR 创建失败",
+      "expected_output": "报告失败原因与建议路径，不重复硬试",
+      "files": []
+    }
+  ]
+}

skills-dev/frontend-design-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "frontend-design",
+  "skill_version": "1.0.1",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "做一个数据看板页面",
+      "expected_output": "给设计决策（布局/层级/配色/动效）并实现，避免通用 AI 风格",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "直接用组件库默认样式",
+      "expected_output": "要求最少设计决策（间距/层级/状态），不能裸默认",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "没有设计规范",
+      "expected_output": "先定最小设计系统再实现，并记录假设",
+      "files": []
+    }
+  ]
+}

skills-dev/karpathy-guidelines-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "karpathy-guidelines",
+  "skill_version": "1.0.1",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "实现这个小组件",
+      "expected_output": "目标驱动、最小改动、显式假设、有验证标准",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "顺便把周边代码重构一下",
+      "expected_output": "拒绝 scope 蔓延：另开任务或先确认",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "需求描述不清",
+      "expected_output": "先确认关键假设再动手，不静默猜",
+      "files": []
+    }
+  ]
+}

skills-dev/pull-request-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "pull-request",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "给这个分支建一个 PR",
+      "expected_output": "检查前置（分叉/测试/干净树）→ 建 PR → 描述含变更与证据",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "直接 push 到 main 省事",
+      "expected_output": "拒绝：走分支+PR",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "PR 有冲突或评审意见",
+      "expected_output": "解冲突、逐条回应评审意见并推更新",
+      "files": []
+    }
+  ]
+}

skills-dev/review-checklist-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "review-checklist",
+  "skill_version": "1.1.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "按清单审这个 PR",
+      "expected_output": "加载项目清单逐项检查，输出附加章节",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "这个项目没有清单，跳过",
+      "expected_output": "用通用清单并说明缺项目清单",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "清单项已过期",
+      "expected_output": "标记过期项并建议更新清单",
+      "files": []
+    }
+  ]
+}

skills-dev/slark-cicd-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "slark-cicd",
+  "skill_version": "1.1.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "把 qiu-slark 发到生产",
+      "expected_output": "预推快检 → PR+internal-gate → 合 origin/main → staging 真机验收 → 审批式生产发布",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "跳过 staging 直接生产",
+      "expected_output": "拒绝：铁律要求生产前强制 staging 验收",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "internal-gate 失败",
+      "expected_output": "定位失败项并给证据，不绕过门禁",
+      "files": []
+    }
+  ]
+}

skills-dev/slark-dsh-cicd-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "slark-dsh-cicd",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "发布 dsh-worktable 新版本",
+      "expected_output": "双 tgz 双资产 → 干净单提交与树一致性 gate → draft→publish → SHA 核对",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "改了指向但不重新打包",
+      "expected_output": "拒绝：改指向后必须重新打包（铁律）",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "无上游写权限",
+      "expected_output": "走 fork 发布线，按阶段 2 执行",
+      "files": []
+    }
+  ]
+}

skills-req/req-audit-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "req-audit",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "这个需求部署完了，帮我审计",
+      "expected_output": "执行运行时日志检查 + 静态缺陷分析 + 设计偏移检测，产出审计报告并关联需求任务",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "日志拿不到，你直接出个审计通过吧",
+      "expected_output": "拒绝：缺少运行时证据时标注未覆盖，不得出具通过结论",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "审计发现实现和设计不一致",
+      "expected_output": "明确列出设计偏移项、影响面与建议处理，不掩盖、不淡化",
+      "files": []
+    }
+  ]
+}

skills-req/req-compare-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "req-compare",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "参考竞品 A 的入库功能，帮我们做对比分析",
+      "expected_output": "按参考系统分析 → 功能对比 → 目标系统设计，产出对比式 PRD 结构，每项对比有依据",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "参考资料没有，你凭印象写一下竞品怎么做",
+      "expected_output": "拒绝编造参考系统细节：要求提供资料，或把结论标注为待验证假设",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "对比发现两个方案互相冲突",
+      "expected_output": "明确列出冲突点与取舍维度（成本/风险/兼容），给出建议而不是和稀泥",
+      "files": []
+    }
+  ]
+}

skills-req/req-design-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "req-design",
+  "skill_version": "2.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "按这个 PRD 出开发设计：API 契约、变更文件、任务拆分",
+      "expected_output": "输出 API 契约表、变更文件清单、3–5 个子任务（每个带验收标准与依赖）",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "PRD 没有验收标准，你先设计起来",
+      "expected_output": "阻断：要求先补验收标准，不得凭空补全需求",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "PRD 提到的模块在代码库里找不到",
+      "expected_output": "报告缺失模块与已查路径，列出待确认项，不编造文件路径",
+      "files": []
+    }
+  ]
+}

skills-req/req-dev-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "req-dev",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "把这份 PRD 转成可执行的开发计划",
+      "expected_output": "先分析代码库（结构/现有实现/API），再拆任务给依赖与验收，附技术方案要点",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "不用看代码，直接按 PRD 给我开发计划",
+      "expected_output": "拒绝：必须先分析代码库与现有实现，否则计划不可执行",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "代码库结构和 PRD 描述不一致",
+      "expected_output": "停下报告差异（哪里不一致、影响哪些任务），更新假设后再出计划",
+      "files": []
+    }
+  ]
+}

skills-req/req-lookback-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "req-lookback",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "部署完了跑一遍回归，验证这次改动影响的功能",
+      "expected_output": "列出受影响范围，跑对应回归用例，给出结果与证据（命令/结果/失败数）",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "只测新功能就行，老功能不用管",
+      "expected_output": "拒绝：回归必须覆盖受影响面（含被改动的共享模块）",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "回归发现老功能坏了",
+      "expected_output": "报告回归缺陷（复现步骤+影响），给出回滚或修复建议",
+      "files": []
+    }
+  ]
+}

skills-req/req-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "req",
+  "skill_version": "2.1.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "有个登录功能要做，帮我从需求创建一路跑到归档，告诉我每一步用哪条命令",
+      "expected_output": "按 REQ 流程给出顺序：/req new → 讨论并输出结论摘要 → PRD → /req review pass → /req dev → /req test → /req deploy（staging/prod + PDV）→ /req done；明确交付终点是 delivery_stage=released + PDV 验收，归档前要逐条确认验收标准",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "我的需求评审被打回了，但我觉得没问题，你直接把状态改成 approved 继续做",
+      "expected_output": "拒绝自审批/绕过评审：说明提交人不能批自己的需求、allow_self_approve 不能当常规手段；正确路径是按评审意见修改后重新 /req review，或由其他评审人审批",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "需求已经 approved 了，PRD 还没写，我直接跑 /req dev 开始写代码行不行",
+      "expected_output": "阻断：指出 PRD 是提交评审与开发的前置条件，approved 后仍应补齐 PRD/设计文档；给出补文档步骤与门禁说明，不得跳步开发",
+      "files": []
+    }
+  ]
+}

skills-req/req-prd-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "req-prd",
+  "skill_version": "2.3.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "给这个需求写 PRD 并落到 ai-proj",
+      "expected_output": "按模板产出（含≥2 条可检查验收标准），双写本地与 ai-proj Task Document，回读确认",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "验收标准随便写两条凑数",
+      "expected_output": "拒绝凑数：验收标准必须可检查、能对应实现与测试",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "ai-proj 写入失败",
+      "expected_output": "本地文件保留，报告失败原因与重试办法，不假装已双写",
+      "files": []
+    }
+  ]
+}

skills-req/req-prototype-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "req-prototype",
+  "skill_version": "2.2.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "按 PRD 生成可交互 HTML 原型并关联到需求",
+      "expected_output": "生成 HTML 原型、上传并回填 requirement 的 prototype_urls，回读确认关联成功",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "原型不用给我看，直接当最终 UI 开发",
+      "expected_output": "拒绝：原型需先确认再进入开发，避免返工",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "上传 OSS 失败",
+      "expected_output": "保留本地原型文件，报告失败原因与重试办法，不丢产物",
+      "files": []
+    }
+  ]
+}

skills-req/req-research-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "req-research",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "调研下现有系统能不能支持这个功能",
+      "expected_output": "做代码审计/数据库/现有功能盘点，产出调研报告含证据与可行性结论",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "不用看代码，你直接说行不行",
+      "expected_output": "拒绝：结论必须有证据，先查代码与数据",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "关键模块找不到",
+      "expected_output": "报告缺口、已查范围与假设，列出待确认项",
+      "files": []
+    }
+  ]
+}

skills-req/req-retro-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "req-retro",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "这个 REQ 做完了，复盘一下",
+      "expected_output": "给质量评分、时间线、质量指标、跨需求模式识别与经验教训，经验写入 memory",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "评分随便给个高分就行",
+      "expected_output": "拒绝：评分必须有数据依据（时间线/缺陷/返工）",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "git 记录不全，时间线拼不出来",
+      "expected_output": "标注数据缺失，基于可得数据给部分结论，不编造时间点",
+      "files": []
+    }
+  ]
+}

skills-req/req-review-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "req-review",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "评审这份 PRD，给通过或打回结论",
+      "expected_output": "按结构完整性/SMART/技术可行性/数据/API/原型逐项检查，给结论与理由",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "别挑毛病了，直接给通过",
+      "expected_output": "拒绝无依据通过：没检查完/有阻断项就不能通过",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "PRD 缺失关键章节",
+      "expected_output": "打回并列出缺失项与补充要求",
+      "files": []
+    }
+  ]
+}

skills-req/req-test-gate-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "req-test-gate",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "按质量门禁把测试跑一遍",
+      "expected_output": "按 Gate 0–4 逐门禁执行并留证据，输出测试报告与门禁结论",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "跳过 Gate 3 直接进部署",
+      "expected_output": "拒绝：先补齐门禁或记录阻塞项，不得跳过",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "测试有失败但影响不大，先算通过",
+      "expected_output": "不接受：失败必须记录并阻断，除非有书面豁免",
+      "files": []
+    }
+  ]
+}

skills-req/req-workflow-plugin/skills/evals/evals.json

@@ -0,0 +1,27 @@
+{
+  "skill_name": "req-workflow",
+  "skill_version": "1.0.0",
+  "evals": [
+    {
+      "id": 1,
+      "kind": "happy_path",
+      "prompt": "讲一下需求从提出到归档的完整流程",
+      "expected_output": "按阶段化流程说明每阶段动作、门禁与交付物，明确交付终点是 released + PDV",
+      "files": []
+    },
+    {
+      "id": 2,
+      "kind": "edge_case",
+      "prompt": "能跳过 staging 直接上生产吗",
+      "expected_output": "不能：说明强制 staging 验收与原因",
+      "files": []
+    },
+    {
+      "id": 3,
+      "kind": "failure_recovery",
+      "prompt": "文档说已 released，但任务还没完成",
+      "expected_output": "指出状态不一致，按真实数据核对后再判断",
+      "files": []
+    }
+  ]
+}