---
name: ai-proj-helper-entry
description: ai-proj-helper 技能库路由：告诉你有哪些技能、什么任务用哪个、以及「REQ released + PDV 通过才算交付」的强制口径。人在开始需求/开发/评审/发布任务前主动调用。
metadata:
  invocation: user-invoked
  owner: qiudl
disable-model-invocation: true
---

# ai-proj-helper 入口（路由器）

## 0. 这个技能是什么

一个**纯人触发**的路由器：人问「该用哪个技能 / 从哪开始」，就读这里。它不进模型目录，所以不占每次会话的目录 token；代价是必须由人主动喊。

> 路由规则：**任何技能增、删、改名、改行为后，必须回改本文件**。一个没提到新技能、或还指向已删技能的路由器，就是假的路由器（见 `skill-creator` §9）。

## 1. 交付终点（强制，优先于路由）

开发任务的交付终点是：需求按 REQ 流程推进到具备发布条件并完成上线（`delivery_stage=released` + PDV 验收通过）。

- 写代码、过单测、提 PR、过 internal gate、合并代码，都是过程节点，**不得当作交付终点**；
- 任务 `completed` ≠ 需求完成；REQ 未 `released` 不得报完成；
- 汇报格式：**当前 REQ 阶段 + 下一个要做的节点**；
- 只有必须由人拍板/授权的阻塞（生产发布授权、密钥权限、需求变更、无法自动修复的失败）才停下来问，并写清卡点与下一步。

## 2. 主流程：需求 → 上线

```
讨论(req) → PRD(req-prd) → 评审(req-review) → 设计(req-design)
→ 开发(dev-coding / karpathy-guidelines) → 测试(dev-test + req-test-gate)
→ 代码评审(dev-review) → 发布(publish / slark-cicd / slark-dsh-cicd) → PDV 验收 → released
```

| 阶段 | 技能 |
| --- | --- |
| 讨论/调研 | `req`、`req-research`、`req-compare` |
| PRD | `req-prd`、`req-prototype` |
| 评审 | `req-review` |
| 设计/拆任务 | `req-design`、`dev-arch`、`db-migration` |
| 编码 | `dev-coding`、`karpathy-guidelines` |
| 测试 | `dev-test`、`req-test-gate` |
| 代码评审 | `dev-review`、`review-checklist` |
| 发布 | `publish`、`slark-cicd`、`slark-dsh-cicd`、`deploy-rollback` |
| 部署后 | `req-audit`、`req-lookback` |
| 复盘 | `req-retro` |
| 项目管理 | `project-management`、`pm-risk`、`pm-ask` |
| 建/改技能 | `skill-creator` |
| 汇报完成前 | `verification-before-completion` |

## 3. 按任务类型的旁路

- 「这个 bug 很难查」→ `diagnosing-bugs`（先建红循环再推理）
- 「帮我审这个 PR」→ `dev-review`
- 「发版」→ 对应 `*-cicd` runbook，不是通用 `dev-deploy`
- 「不确定该用哪个」→ 读到这里就够了，别猜

## 4. 红线

- 不得自审批（提交人不能批自己的 REQ）
- 不得绕过门禁（测试 Gate、发布 Gate、归档 Gate）
- 不得把「某步骤完成」当结束
- 不得无证据声称完成（见 `verification-before-completion`）
- 不得把凭据/内网地址/绝对路径写进技能或文档

## 5. 技能从哪来

- 用户级：`~/.agents/skills/`（Codex）、`$DSH_HOME/skills/`（DSH）
- 项目级：项目根 `.agents/skills/`
- **真相源**：`ai-proj-helper` 仓库；本机目录是安装产物，不要直接改
- 个人技能：`skills-personal/`（不入库、不发布）

## 6. 维护检查

- `./install-skills.sh --audit` 漂移数 > 0 → 先同步再干活
- 技能有增删改 → 本文件 + `catalog.json` 必须同 PR 回改
- 每季度人工过一遍本路由，删掉不再用的技能引用