johnQ
d43b414fc9
- 新增 SCOPE.md 收录门槛 + .out-of-scope/ 拒绝档案 - 生命周期分桶 promoted/beta/deprecated，marketplace 只发布 promoted - 调用模式 model-invoked/user-invoked（user-invoked 不占模型目录） - 新增脚本 validate-skills.py / generate-catalog.py / scan-skill.sh(+allowlist) - 新增 beta 技能 skill-creator、ai-proj-helper-entry、verification-before-completion（各带 evals） - install-skills.sh: --agent dsh / --link / --audit / --include-beta / --no-validate - 融合：dev-review 接收评审意见、req-design 依赖边、agent-swarm 并行编排、dev-test TDD - catalog.json 61 个技能（58 promoted / 3 beta）；validate 0 错误；scan 0 高危；现有测试通过
78 lines
3.5 KiB
Markdown
78 lines
3.5 KiB
Markdown
---
|
||
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 回改
|
||
- 每季度人工过一遍本路由，删掉不再用的技能引用
|