skills/skills/skill-forge/references/quality-gate.md

质量闸门 — 生成后逐条自检

任何一条不过，回到对应步骤补料重生成该节。不许带红灯交付。

自检清单（10 条）

1. 触发接住测试：拿出用户最可能说的 3 句原话（含一句不带术语的"小白说法"），description 能接住几句？接不住 → 回第 0 步补触发词
2. 症状触发：用户带着报错/故障现象来时，description 里有没有错误码/症状原文？（没有症状类触发的工具型 skill 可豁免，注明理由）
3. 边界划界：与现有 skill 名单对过没有？"不归我管"有没有写、路由到谁？
4. 第 0 步存在：有没有"备料/定位"前置步？缺料行为是不是"停下来教用户"，而不是"猜一个继续"？
5. 每步带验收：数一遍，有没有步骤没有 → 验收：？完成定义是不是"真环境走通"，而不是"命令返回 ✓"？
6. 约束带依据：每条硬约束后面有没有"为什么"？说不出的有没有降级成 warn 或删掉？
7. fail-fast 分级合理：die 的场景是否都不可逆/高代价？warn 有没有写明"为什么不拦"？是否至少考虑过"哪条 die 故意不留绕过口"？
8. 确认闸就位：所有写/不可逆动作，默认是不是"不写"？模棱两可时的默认动作写了没有？
9. 密钥卫生：生成的文件里有没有混入真实密钥/令牌？密钥是否被明确"绝不进配置文件/对话/argv"？
10. 汇报结构固定：有没有固定汇报栏目？"被跳过的 / 没写成的 / 验证做到哪一步"三栏齐不齐？

模式速查（从成熟 skill 抽象，供各步骤给默认值用）

• description 配方：中文长描述（用途+原话枚举+"即使用户没说 X"）+ 英文 Use whenever… + 边界路由
• 骨架：备料 → 调查/预检 → 执行 → 验证 → 汇报；第 0 步恒为备料；写入与汇报恒在最后两步
• 约束三件套：规则 + 为什么（事故依据/症状） + 绕过前须知
• die 三段式：是什么 + 为什么（后果） + 怎么办/绕过参数
• 凭证分流：身份落盘 / 环境走 env / 密钥绝不进文件；环境变量优先；缺了停下教用户，不猜不翻
• 权责：Agent 只建 draft，终态是人的；写前确认闸；做不到的列"待人工补"
• 排障表：症状 → 原因 → 怎么办；重点收"构建全绿线上却坏"类成因
• 汇报伦理：固定结构；没验证就说没验证；不静默截断
• 工程化：自包含目录（SKILL.md + references/ + scripts/ + .example + .gitignore）；references 按需读；scripts 零依赖优先