用途：这是 agentmemory 技能的“内部格式与规则”，用于新增技能、重构已有技能或审阅技能时保持统一、可快速浏览且准确。
目录结构：plugin/skills/<name>/ 下包含 SKILL.md（必需，少于 100 行）、REFERENCE.md（可选，密集事实，数据表自动生成）、EXAMPLES.md（可选，示例对话记录）、TROUBLESHOOTING.md（生成的支撑文件）。
SKILL.md 规则：frontmatter 含 name、description、可选 argument-hint 和 user-invocable；仅当技能由用户以斜杠命令运行时设 user-invocable: true，参考与知识类技能为 false。description 为两句话，是智能体决定是否加载技能时唯一看到的内容：第一句说明能力，第二句以 Use when 开头并列出具体触发条件；需与同类技能区分，少于 1024 字符，用第三人称。正文顺序：Quick start（一个具体示例）、Why（核心原则）、Workflow（带决策门的编号步骤）、Anti-patterns（针对最常见错误的 WRONG 与 RIGHT 对照）、Checklist、See also（交叉链接同类技能）、Reference 或 Troubleshooting 指引。保持少于 100 行，密集事实移入 REFERENCE.md，示例移入 EXAMPLES.md。支撑文件放在技能目录内，使技能可独立安装；链接 TROUBLESHOOTING.md，生成器会把共享恢复说明复制到每个技能根目录。
保持最新：源码中存在的事实（工具名与参数、REST 端点、环境变量、连接适配器、钩子事件）由生成器产生，不得手写；修改源码后运行 npm run skills:gen。CI 运行 npm run skills:check，出现漂移即失败，因此生成的表格不会落后于代码。
风格：不出现外部或竞品产品名，不用 emoji，不用破折号，不写填充内容，陈述事实即止。
检查清单：description 含带真实触发条件的 Use when 句；SKILL.md 少于 100 行；无时效性声明、无重复的故障排查块；有具体示例且生成事实来自生成器；交叉链接可解析且只深入一层。