提示静态检查规则
用脚本对提示做发布前静态检查：占位符是否配对、模板变量是否已在注册表登记、是否混入疑似密钥或内网地址、输出格式说明是否配了示例或字段表。这些问题挡在上线之前，代价远低于线上事故，也省掉了评审时靠人眼找格式错的机会。
基本信息
| 检查项 | 占位符配对、变量登记、敏感串扫描、结构完整性 |
|---|---|
| 接入方式 | 仓库提交前钩子或持续集成检查皆可 |
| 失败处理 | 报错必须给出文件与行号，并支持一键复现 |
| 豁免机制 | 历史模板设基线豁免清单，新问题不允许新增 |
| 演进 | 每次线上出现格式类事故，考虑能否加一条检查项 |
典型使用场景
- 提交检查：占位符少一个括号这类错误在提交阶段就被拦下
- 变量核对：模板新增变量但没登记时直接失败
- 敏感串扫描：防止把内网地址或密钥误写进提示文件
- 结构校验：要求输出格式说明必须配字段表或示例
- 历史债管理：老模板列入豁免清单，逐步修正而不是一次性报错
检查项与输出示例
检查项与输出示例
检查项:
- 占位符配对: 双大括号计数是否一致
- 变量登记: 模板变量是否都出现在注册表中
- 敏感串扫描: 疑似密钥、内网地址、个人信息
- 结构完整性: 输出格式段是否配有示例或字段表
输出示例:
FAIL summarize/v3.md: 变量 max_points 未在注册表登记
FAIL extract/invoice: 疑似内网地址 10.20.3.7 出现于正文检查项与级别
| 检查项 | 级别 | 说明 |
|---|---|---|
| 占位符配对 | 错误 | 直接影响渲染，必须拦下 |
| 变量登记 | 错误 | 未登记变量等于调用约定缺失 |
| 敏感串扫描 | 错误 | 命中即阻断，人工确认后加例外 |
| 结构完整性 | 警告 | 可先告警，稳定后再升级为错误 |
| 长度与格式偏好 | 提示 | 仅提示，不阻断发布 |
检查规则要能在本地跑：只存在于流水线里的检查，开发者要等一次构建才知道结果，通常会被当成噪音。