> 族内折叠指针(技能质量管理族 · 体检段)
> 本技能已归入 zfl-skill-quality-checker(本段唯一入口)。日常使用请从主技能进入。
> 目录与脚本资产保留,供主技能及其他技能直接调用,请勿重复实现本技能已有能力。
约束与错误处理
- 本技能仅处理其声明范围内的任务,不越界执行未授权操作。
- 错误处理:输入不合法时返回明确错误说明,不静默跳过;依赖缺失时降级提示并给出替代路径。
参考文档
- 本技能暂无外部参考文档。相关规范见同生态 zfl-common 共享库。
不适用场景
- 不适用于需要实时交互或外部 API 调用的场景。
- 不适用于超出本技能声明范围的任务类型。
输出与格式
- 输出格式:结构化文本,包含明确的章节划分与关键结论。
- 输出结构:按任务类型返回对应格式,确保可读性与可追溯性。
示例(全库触发词扫描 → 近义/重复冲突定位 → apply 修复)
场景:怀疑多个技能触发词打架(用户一句话同时命中两个技能),要盘点全库触发 schema 并去重。
1. 全库扫描:对整个 skills 根目录跑扫描,出分类清单(复合式/领域触发/纯触发词/纯场景/缺字段)+ frontmatter 卫生问题。
2. 定位冲突:看 --json 里的近义/重复项与桥接候选,锁定打架的触发词对。
3. 预览修复:先不带 --apply,核对 proposals 建议(删冗余触发词 / 升级复合式)改到哪个技能。
4. 落地修复:确认建议后加 --apply --yes 写盘,再复扫一遍确认冲突清零。
实际命令形态(<skills_root> 为技能根目录占位符):
# 1) 全库扫描,出 Markdown 报告落盘(分类清单 + frontmatter 卫生问题)
python <skills_root>/zfl-skill-trigger-audit/scripts/scan_trigger_schemas.py --base <skills_root> --out trigger_report.md
# 2) 结构化 JSON 结果(含近义/重复项与桥接候选,便于下游比对冲突)
python <skills_root>/zfl-skill-trigger-audit/scripts/scan_trigger_schemas.py --base <skills_root> --json