用途：ms 是 meta_skill 的检索与加载引擎，覆盖 agentops 和 jsm 两个已配置语料，用于在技能库中查找并加载指导内容。检索结果与来源身份返回给调用方，由调用方自行决定后续流程。
主要能力：优先通过 MCP 工具使用——mcp__ms__search {query} 做 BM25 搜索，mcp__ms__load {skill, full: true} 一次返回完整可运行的 SKILL.md，mcp__ms__show 返回元数据卡，mcp__ms__suggest {cwd} 按目录推荐技能（其项目语言检测可能误判，仅为外观问题）。没有挂载 MCP 工具时，用一次性 helper：python3 skills/ms/scripts/mcp-search.py "<query>"，默认 30 秒超时，可用 MS_BIN、MS_MCP_SEARCH_TIMEOUT 或 --timeout 覆盖。CLI 加载回退：ms load <id> --full -O json | jq -r '.data.content'。
写入与管理：反馈和结果只信任 CLI 写入路径，ms feedback add <skill> --positive/--negative --comment "..."；ms outcome <skill> --success/--failure 仅在下方工厂实际使用并获得验证后记录。另有 ms doctor、ms list、ms config。重建索引只能通过 scripts/ms-reindex.sh，必要时加 --check-source，可用 MS_REINDEX_MIN_INDEXED 设定下限。
限制：任何重建或清库后，所有正在运行的 ms mcp serve 必须全部杀掉，否则会静默读取旧数据并把写入落到孤立文件。加载即执行时必须 full: true 或 --full，--pack N 只返回被削弱的概览层。CLI 的 ms search 实际只有 BM25，零结果不代表 MCP BM25 无匹配。ms 不跟随目录符号链接，skill_paths 需显式列出两个根目录。二进制仅源码构建（~/dev/meta_skill，分支 local/frontmatter-id），0.1.2 发布版会破坏 ID。本地索引是一次性状态，skills/** 才是权威源；ms 不校验或解释下游工作，检索本身不构成改进证据。状态根在 ~/Library/Application Support/ms/。