一、用途
该 skill 用于创建、改进或审计 agent skill，并维护 skill 骨架标准。触发场景包括：做 / 沉淀 skill、重做某个 skill、改 skill 或其触发描述、审计 skill、改骨架标准 / 模板。明确不适用：skill 机制答疑、调试 skill 的脚本代码、删除 / 发布 / 批量迁移。
二、主要能力
- 创建：制作新 skill；整体重写现有 skill 正文（重做）也走创建流程，各步的重做场景条款适用，步骤见 ref/create.md。
- 改进：通读目标 skill，定位改动涉及的节并按节内容边界归位新内容；改动面是整个 skill 目录（frontmatter / 正文 / ref / tools / eval 联动）。改 description 时按 description 写法复核关键词与真实请求的对应；被质疑某句时先按删行测试尝试直接删除，删不掉才改写。涉及本 skill 模板或设计原则 / 写作原则时，先经用户确认，模板与正文同批改完，改完全仓跑一遍 check，过不了的老 skill 列成清单交用户定处置。一批改动触及多节或多文件时，交付前提议对目标 skill 全文审计（经用户点头才执行），单点编辑豁免。行为性改动需做有效性验证：用触发本次改动的失败场景重跑，不得再那样失败；有 eval/evals.json 的一并跑回归，复现用例追加进去；改 description 的跑触发正负例，方法见 ref/qualitative-loop.md；单点编辑豁免，发起验证前需问用户（subagent 有成本）。
- 审计：跑 python3 yzr-skill-management/tools/skeleton.py check <skill-dir>，目标 skill 有 tools/ 时加跑冒烟，失败一并列入报告；精读 skill 目录全部文件，结构项与文字项逐条给结论，每条附文件与原文引用为证据；报告每条有处置与去向，未处置不得收工，违反项附改法建议，修复经用户点头后走改进，删行测试不过的列入待删候选，纯文字质量转 yzr-writing-review，tools/ 代码与脚本转 yzr-coding-review。
三、执行原则
设计原则：单一来源，同一规则或事实只写一处，形状归模板，能自动判定的检查归脚本（脚本从模板读取，不内嵌定义副本），其余内容默认归 SKILL.md，多到值得拆时进 ref/，其余位置只引用不转述；机械活脚本化，能自动判对错的检查、零判断可枚举的重复动作写成脚本，不合算的不做（误报太多或比规则还重的检查不立，一行 shell 能做完、一年跑不了几次的动作不写成脚本）；执行路径从简，能一次调用做完的不拆成多步，能一次读完的不让读两次，能并行发起的不串行；先文字后脚本，文字办法确实不够用了再动脚本和检查器；脚本黑盒化，agent 调用脚本不读源码，对外契约全写在 --help 里；目录按需建，ref/ 用于执行细节超过一屏或几个地方都要读，tools/ 用于有值得写成脚本的检查或重复动作（冒烟测试放 tools/tests/），assets/ 用于可拷贝的模板或静态资源，eval/ 用于要跑定性测试，这些目录只放按场景才读的内容，每次激活都要读的留在正文；依赖不成环，skill 之间依赖单向，靠语义判断不做自动检查；不替用户设计，素材与用户确认都没覆盖的细节不自行补齐默认值，素材没回答的决策点列成开放问题交用户定，写进正文的每条规则都要答得出出处。
写作原则：删行测试，description 每次会话注入、正文每次激活整篇加载，对每一行问删掉它称职的 agent 会做错事吗，不会就删，规则的为什么只在改变边界行为时留在正文，其余归档进 commit，门禁全绿只证形式合规；不写演进史，修改日期、改动原因、新旧对比归 commit；直陈，陈述句直写，不起绰号、不造小标题式的新词；标点从简，条目句末不加句号，全角标点照常，全角符号不用（★、▶、→ 这类图形 / 装饰符号），转折承接用文字写，句中标点只在帮着断结构时用，引文、代码与模板槽位不动；排版不渲染，读者是 agent，读原文不读渲染结果，表格、mermaid、ASCII 图这类排版语法不写；节内容边界，每节只写节名所指的内容；引用不用序号，交叉引用用名称或链接。
四、使用方式
按诉求分流：做新 skill 走创建；整体重写现有 skill 正文（重做）走创建；改现有 skill（含本 skill 的模板与设计原则 / 写作原则）走改进；检查 skill 是否符合标准走审计。创建与改进的最后一步都是收口：check 全绿，目标仓库有 lint / format 门禁的一并跑，有 tools/ 时跑其冒烟，交用户过目。审计时运行上述 check 命令并做精读与报告。
五、输入与输出
输入为用户诉求与目标 skill 目录（创建可无目标；标准维护的目标是模板与本文件）。输出：审计只交付报告、不改文件；创建 / 改进交付 skill 改动。
六、限制
不处理 skill 机制答疑、调试 skill 的脚本代码、删除 / 发布 / 批量迁移；依赖判断靠语义，不做自动检查；有效性验证因 subagent 有成本，发起前须问用户；涉及模板或核心原则的改动须先经用户确认。