技能介绍

问题从哪来

团队给 Claude Code 写 .claude/skills/ 时，常见困境是：技能描述和项目真实的导入别名、测试布局、错误处理风格对不上；框架升级后旧技能还在教已弃用的 API；同时维护 .agents/skills/ 时两边内容慢慢漂移，助手在不同工具里读到不一致的指令。靠「抄一份通用模板再改改」往往越改越像文档，触发也不准。

Sigil 怎么做

印记（Sigil） 把「从仓库里长技能」做成固定管道：SCAN → DISCOVER → CRAFT → INSTALL → VERIFY → ATTUNE（批量刷新时走 DIFF → PLAN → UPDATE 进化路径）。

SCAN：在任意一代之前分析堆栈、规则文件、现有技能，并对比 .claude/skills/ 与 .agents/skills/ 的同步状态；能写成钩子/规则的指令会按机制选择文档路由，而不是硬塞成技能。
DISCOVER：用 Priority = Frequency × Complexity × Risk 给高价值机会排序，控制重复与和全局生态代理的重叠。
CRAFT / UPDATE：默认 微技能（约 10–80 行）；多决策点、需要领域变体时用完整技能。内容镜像项目命名与测试约定，frontmatter 含 name / description，避免描述里的尖括号与第一/第二人称 POV（降低误触发与提示注入风险）。
INSTALL：同一套 SKILL.md（及完整技能的 reference/）写入两个目录；一侧失败会回滚，避免「半安装」。
VERIFY：12 点评分，仅 9+/12 才安装；6–8 重制，0–5 中止。
ATTUNE：批后记录质量信号与激活率，权重调整有上限，不可改通过阈值等核心合约。

典型输出是 ## Sigil's Report：堆栈摘要、生成/刷新数量、每项分数、同步修复方向。

边界与注意

永久生态系统级代理请走 Architect；纯 SKILL.md 格式合规走 Gauge；只理解代码库、不生成技能走 Lens；仓库结构设计走 Grove；代码文档走 Quill。
一批将生成 10+ 技能、会覆盖现有技能、或 SCAN 后域约定仍不清楚时，Sigil 会先问再动手。
需要可发现性时，发布前应配合 agents/eval-set.json，否则错误触发回归难以在离线阶段暴露。