如何玩转 LoopX 能力目录 APIcapability list 与 show 命令 JSON 契约完全指南【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopxLoopX 是面向长周期 Agent 的控制平面统一治理 Codex、Claude Code 等 harness 上的持久化工作。它的能力目录 API通过loopx capability list与loopx capability show两条命令输出带版本号的JSON 契约让你用一条命令就能查到当前安装版本支持哪些能力、每个能力的入口命令、写入边界和验证状态——无需翻源码、无需猜参数。为什么需要 capability 命令LoopX 内置了 20 个产品级 Capability如 issue-fix、explore、decision-context、periodic-report 等每个能力都由独立的 Provider 实现并且有自己的成熟度状态、写入边界和冒烟验证。目录数据是活的扩展Extension安装后能力会动态变化所以官方要求以运行时命令输出为准而不是依赖静态文档。目录数据构建逻辑loopx/capabilities/catalog.py注册与校验逻辑loopx/capabilities/registry.pyCLI 命令入口loopx/cli_commands/capability.pycapability list一键获取全量能力清单运行下面的命令即可拿到当前安装版本的权威目录默认输出 Markdown加--format json得到结构化数据loopx capability list --format jsonlist 命令的 JSON 契约输出的顶层结构由 schemaloopx_capability_catalog_v0定义共 4 个字段字段类型说明okboolean是否成功true表示目录构建无误schema_versionstring固定为loopx_capability_catalog_v0capabilitiesarray能力摘要列表每个能力一条记录providersarray全部 Provider 及其生命周期状态每条能力摘要包含 13 个字段id、title、status成熟度、originbuiltin/extension、visibilitypublic/internal、provider_id、provider_state、real_world_anchor解决的真实问题、entry_command入口命令、documentation_route、implemented_protocol_count、implementation_provider_count、smoke_count、next_real_step。读懂 provider_state能力可用的四级阶梯每个 Provider 都有 4 个布尔状态且有严格的蕴含关系源码中强制校验状态不合法会直接报错declared已声明 → installed已安装 → enabled已启用 → ready就绪可用这意味着你看到ready: true才能放心调用对应能力如果是declaredtrue但readyfalse说明能力只是被声明、尚未真正落地。这是判断这个能力现在能不能用的最可靠依据。capability show深入单个能力的完整契约选定能力 id 后用 show 命令查看它的完整详情loopx capability show issue-fix --format json输出的顶层结构由 schemaloopx_capability_detail_v0定义ok、schema_version以及一个capability字段承载完整记录。detail 记录里有什么与 list 的摘要不同detail 记录额外展开了以下关键信息commands每个子命令的command、purpose用途与write_boundary写入边界例如 decision-context 的prepare-evidence明确标注read-only provider accessimplemented_protocols该能力实现的全部协议 schema、所在模块与文档路径smokes可直接运行的持久验证脚本路径boundaries写入与可见性边界清单agent_usage给 Agent 的使用提示、推荐执行顺序与选择规则next_real_step该能力当前的下一步真实验证动作常见用法速查清单你想做什么推荐命令枚举当前版本全部能力loopx capability list --format json查看 issue 修复能力详情loopx capability show issue-fix --format json查看探索研究能力详情loopx capability show explore --format json查看定时报告能力详情loopx capability show periodic-report --format json临时挂载扩展能力清单不安装loopx capability list --extension-manifest path --format json几个实用技巧用id做脚本断言脚本中解析capabilities[].id即可做版本能力检测比解析人类可读文本稳定得多。临时探测扩展--extension-manifest允许在不安装的前提下把扩展清单声明进目录此时未就绪的 Provider 会显示declaredtrue且installedenabledreadyfalse。internal 能力默认隐藏visibility: internal的能力在默认目录下不出现适合团队内部能力隔离。Markdown 输出省略--format json时list 渲染为能力卡片列表show 渲染为含 Commands / Agent Usage / Implemented Protocols / Smokes / Boundaries 分节的详情页适合直接贴进笔记。目录数据的可信度从何而来注册表在构建时强制执行一组契约校验保证输出的 JSON 不是随意拼装的数据每个能力必须声明id、title、status、user_value、next_real_steppublic 能力还必须有real_world_anchor和entry_command能力的origin必须与其 Provider 的origin一致跨 Provider 重名能力直接报错public 内置能力必须携带包内文档元数据documentation_route由此派生这些规则的实现见 loopx/capabilities/registry.py单条能力的完整数据结构可参考 loopx/capabilities/decision_context/catalog_entry.py。延伸阅读人类可读的 Capability 索引按结果选择能力loopx/capabilities/README.mdExtension 与 Capability 开发参考docs/reference/extensions.md扩展能力接入与准入逻辑loopx/extensions/capability_admission.py官方能力目录契约的更多上下文README.zh-CN.md 中产品 Capability 路径一节掌握capability list与capability show的 JSON 契约后你就能把LoopX 现在能做什么变成一个可编程、可验证、可版本化的问题——这正是长周期 Agent 治理的第一步。【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考