meta-skills

用途

Meta-Skills 面向智能体技能（Agent Skills）的编写、组合与改进，提供两类内容：一是组合模式（Composition Patterns），用于组织和编排技能；二是元技能框架（Meta-Skilling Framework，MSF），用于从零构建新技能。其核心操作原则是“蒸馏不可省略”：每个用户请求遵循 ORIENT → PLAN → EXECUTE → VALIDATE → DISTILL → DELIVER 六步循环，其中 DISTILL 必须以提案形式进行，而非静默写入。若任务产生了新洞见、变通方法、修正或流程，需先起草技能更新（或新技能），并在修改磁盘技能文件前获得用户明确确认。技能文件即持久记忆：未写下的内容在下次会话中不存在，未经审查写入的内容可能污染后续会话。

主要能力

组合模式

技能路由：顶层编排技能根据任务类别路由到具体子技能，并提供跨领域关注点（单位、命名、验证）。
分块处理：通过批次上限（复杂资产 N=10-20）和分层处理（先叶子资产、再组合、后顶层）防止上下文溢出，每块处理后总结并检查点。
质量门禁：发布前强制外部评审，经用户确认后仅上传至 localhost 的 $IMAGE_SERVER_URL（通常 http://localhost:8092）供视觉 LLM 摄取，拒绝非 localhost 地址；要求最低分数（如 7/10）后才分享。
自主修改的安全护栏：参数最大为基线的 N 倍（如 10 倍）、绝对上限（如 5000）、不允许符号翻转、保留前后变更审计轨迹、针对基线做漂移检测。
多技能组合：复杂任务显式声明技能依赖，每个依赖是可独立使用的完整技能。
集群编排：将分布式计算资源作为集群管理，包括预检验证、僵尸进程清理、基于 SSH 的部署与 git 提交跟踪、集中监控、基于种群的训练。
渐进式披露：技能文件前置最常见操作，深层参考资料后置。

简洁技能（符合 Anthropic 规范）

硬性约束：SKILL.md 正文 ≤ 500 行；description ≤ 1024 字符，第三人称，包含 WHAT + WHEN + 触发词；交叉引用仅一层深；不得硬编码用户路径、IP 或时效性短语。

关注点分离（三文件模式）：过程性内容留在 SKILL.md；≥20 行可复用代码提取到 scripts/<name>.py；深层参考/案例/经验放入 <topic>.md 同级文件。触发条件：SKILL.md 超过 500 行、≥50% 为代码块、或含 5 个以上带日期的“Learned”小节。
代码即引用而非技能本体：≥20 行代码块提取为可调用函数，SKILL.md 保留函数签名、一行描述与路径链接；5-20 行块若为主要示例可内联；≤5 行单行命令与配置片段可内嵌并注明验证过的 API 版本；表格、决策树、参数范围保留内联。
description 预算：第一句（≤200 字符）说明产出或覆盖内容；第二句（≤200 字符）说明拥有的关键概念/API；第三句（≤200 字符）以“Use when …”给出 3-5 个具体触发短语；可选“See also …”指向同级技能。避免把 description 写成目录。
拆分/合并/交叉链接决策树：严格子集则删除子集并吸收独有内容；共享基底但专精不同则提取共享基底为第三技能；同一领域不同抽象层级则合并并加“何时使用本技能（对比同级）”小节；彼此独立但常一起使用则交叉链接并明确 RECEIVES from / PRODUCES for。反模式：以具体资产/任务命名的窄范围项目产物应折叠进通用父技能或删除。
带路由、质量门禁与交付前蒸馏的层级：请求 → 路由器（父）→ 专家子技能 → 质量门禁 → 蒸馏 → 交付。三个结构关注点均不可省略：路由（父 SKILL.md 路由表）、质量门禁（常设清单 + 决策树 + 反馈循环）、交付前蒸馏（用户确认后再写入）。适用于 3 个以上子技能的层级、含中间产物的流水线阶段或交付缺陷反复出现的领域。
环境变量而非用户路径：用 $ISAAC_SIM_DIR、$SIMREADY_ASSETS、$KB_SERVICE_URL（默认 http://localhost:8095）、$IMAGE_SERVER_URL 等替代绝对路径与硬编码 IP；编排技能拥有环境变量契约，各技能文件只引用变量、不声明值。

元技能框架（MSF）

适用于开始学习任何新工具、领域或能力；构建技能层级；审查现有技能是否需要迭代。五个阶段：

发现：识别需求、定义范围、拆解子技能、研究资源、设定能力目标、检查现有技能是否重叠。产出初始 SKILL.md。
实践：沿学习路径动手做小任务、边做边记、识别可复用模式、标记难点作为迭代目标。产出原始实践笔记、初始脚本、已识别模式。
捕获：将笔记整理为结构化章节、按模板标准化、保存脚本与参考文档、从 v0.1 开始版本化、链接相关技能。关键规则：不在文件里，下次会话就不存在。
验证：仅用文档内容完成真实任务、对照目标检查、标记“验证缺口”、获取反馈。
迭代：会话开始时回顾缺口、研究解决方案、更新并版本化、扩展范围、重新验证。

技能层级模式：父级 SKILL.md 含概览、技能树与进度跟踪；子技能链接回父级；跟踪依赖；先掌握基础子技能再处理依赖项。

SKILL.md 模板包含：When to Use This Skill、Related / Integration Points（RECEIVES from / PRODUCES for）、Core Concepts、Key Workflows、Decision Trees、Failure Modes & Recovery（FAILURE / SYMPTOMS / CAUSE / RECOVERY / PREVENTION）、Expert Intuition、Context Matrix、Environment Requirements 等章节。

使用方式

该技能以模式与流程指导技能编写与组合。执行时遵循六步循环，DISTILL 阶段以提案形式产出技能更新并等待用户确认。涉及技能库写入或 $IMAGE_SERVER_URL 上传时，均需用户确认。

适用场景

编写、组合、改进智能体技能。
构建多子技能的技能层级与流水线。
从零学习新工具或领域并沉淀为技能文件。
审查现有技能是否需要拆分、合并或交叉链接。

限制

除非某节另有说明，目标为 Isaac Sim 6 / Kit 110。
不替代 NVIDIA 官方文档处理不支持的边缘情况。
DISTILL 提出持久技能更新，不会静默重写技能库。
前置条件：已构建的 Isaac Sim（$ISAAC_SIM_DIR 或 _build/linux-x86_64/release）；带当前驱动的 NVIDIA GPU（nvidia-smi）；来自 isaac-sim-orchestrator 的 shell 环境契约（$ISAAC_SIM_DIR、$ISAAC_LAB_DIR、$WORKSPACE_DIR）；技能库写入或 $IMAGE_SERVER_URL 上传前需用户确认。
故障排查：扩展或导入未找到（$ISAAC_SIM_DIR 错误或构建过期）；黑屏或空帧（缺少灯光或非 RTX 渲染模式）；阶段加载或首次渲染挂起（MDL 编译或阶段过大）。

技能介绍

用途