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 高危；现有测试通过
2.0 KiB
2.0 KiB
Scope — ai-proj-helper 技能的收录门槛
本仓库是团队每天在用的技能集，不是技能收藏夹。技能目录会在每次会话启动时占用模型的上下文预算，所以「多加一个」永远是有代价的。
门槛
新技能或改动默认拒绝，只有同时满足两条才进入评审：
- 真实失败：能说清在哪个真实任务/会话里出了问题——跑了什么、期望什么、实际什么。假设性的「这样会更好」不算。
- 组合不出来：用现有技能组合做不到。能组合的，改现有技能，不新增。
规模不重要：一个词的修改和一次重写按同一标准审。
分桶
| 桶 | 含义 | 安装 | 进 README / plugin.json |
|---|---|---|---|
promoted |
已验证、日常在用 | 默认 | 必须 |
beta |
公开试跑、收反馈 | --include-beta |
不进默认清单 |
deprecated |
不再使用 | 不安装 | 只留文档，标弃用 |
新技能一律先进 beta；promoted 需要真实使用记录 + evals 通过。
调用模式
model-invoked（默认）：进模型目录，agent 自己判断何时用。user-invoked：只由人下命令触发，不占目录预算；必须写disable-model-invocation: true+metadata.invocation: user-invoked。
判定：这件事是不是「人下命令才开始」？是 → user-invoked。
已经拒绝的想法
每个被拒概念一个文件，写在 .out-of-scope/ 下，先读再提。当前已有：
提交流程
- 先过
skill-creator的收录门槛与质量门禁。 python3 scripts/validate-skills.py通过。./scripts/scan-skill.sh无高危项。python3 scripts/generate-catalog.py更新catalog.json。- 版本号 + CHANGELOG 更新，走 PR。