Files

T

johnQ d43b414fc9 feat(skill): 技能治理 v0.2 —— 分桶/调用模式/校验/安全/清单/安装矩阵

- 新增 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 高危；现有测试通过

2026-10-31 22:03:13 +08:00

3.5 KiB

Raw Blame History

name, description, metadata, disable-model-invocation

name

description

metadata

disable-model-invocation

ai-proj-helper-entry

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

invocation	owner
user-invoked	qiudl

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 回改
每季度人工过一遍本路由，删掉不再用的技能引用

3.5 KiB Raw Blame History Unescape Escape