用途
本技能用于设计或审查编码智能体 CLI 的斜杠命令层，包括命令注册表形态、类型化命令种类、懒加载、来源感知发现，以及跨本地、远程和桥接模式的安全分发。它负责编码智能体的命令运行时架构；更广泛的智能体创建应参考 ../ai-coding-agents/SKILL.md。
主要能力
- 命令注册表与发现：注册表模型、命令种类、加载顺序、来源优先级。
- 命令分发、分叉与远程安全：分发规则、分叉执行、远程安全过滤、桥接门控。
- OpenAI Codex 斜杠命令可用性建模：命令元数据、内联参数支持、活动任务可用性、侧会话可用性。
使用方式
默认工作流：
- 分类命令界面，区分提示扩展命令、本地文本命令和本地 JSX 或 TUI 命令。
- 定义注册表契约，保持单一类型化命令接口，字段稳定涵盖名称、别名、来源、可用性和启用状态。
- 显式建模加载顺序：先加载捆绑与内置条目，再加载技能、插件、工作流及动态发现，并保持确定性优先级。
- 保持懒加载，重型实现应在调用时加载，而非注册表引导阶段。
- 决定哪些命令可被模型调用；提示式命令和技能需要额外字段描述、参数提示、分叉行为和工具许可。
- 区分 UI 安全与桥接安全，远程和桥接客户端只应看到无需本地终端交互即可执行的命令。
- 将分叉命令视为子智能体编排，赋予显式允许工具、智能体选择和运行时作用域上下文启动模式。
- 显式处理缓存失效，记忆化命令发现必须有宿主拥有的失效路径。
- 用冲突用例验证：别名、重名、缺失加载器、鉴权门控命令、过期缓存和模式特定过滤。
宿主规则：所有命令来源共用一种注册表类型；显式声明命令种类；区分静态可用性与动态启用；默认懒加载；允许重型命令暴露轻量垫片；提示命令保持声明式并带来源标签；远程与桥接执行使用显式允许列表；动态发现命令按规范文件身份去重。
适用场景
- 为编码智能体 CLI 或 REPL 设计斜杠命令架构。
- 从内置、技能、插件、工作流或 MCP 支持来源添加命令。
- 定义提示、本地文本、本地 JSX 或 TUI 等命令种类。
- 审查别名、即时性、可用性门控或来源感知命令格式化。
- 在混合运行时中分离桥接安全、远程安全和仅终端命令。
限制与注意事项
- 核心不变量：每个命令必须有一条类型化分发路径；可用性与启用状态不是同一字段；命令名与别名必须确定性解析；远程安全与桥接安全命令集必须显式；重型命令实现应在调用时加载；记忆化命令发现必须有显式失效触发。
- 失败模式包括：重名或别名胜出不稳定；模式过滤将仅终端命令泄漏到远程客户端；动态技能缓存过期；加载器失败导致整个注册表崩溃；分叉命令继承超出预期的上下文或工具。
- 已知陷阱：合并内置、插件和仓库本地命令时缺乏确定性优先级模型；将别名展开视为纯字符串替换而丢失权限、遥测和分叉语义所需元数据；记忆化发现结果却没有显式失效路径。
- 常见反模式：仅从文件位置或命名推断命令种类；将鉴权或功能标志状态视为静态注册表形态的一部分；启动时急切加载所有命令；假设本地 REPL 中可见的命令在远程或移动控制路径中有效。
- 判断要点：桥接安全过滤是信任边界控制，不是 UX 细节；优先级顺序首先是安全决策；上下文与工具继承是独立轴；当静态命令少于约 10 个且无插件、技能或远程客户端需求时，完整类型化注册表可能过度设计。
相关技能
- 更广泛的编码智能体架构：../ai-coding-agents/SKILL.md
- 插件包与扩展架构：../ai-coding-agents-plugins/SKILL.md
- 工具注册表与工具执行语义：../ai-coding-agents-tools/SKILL.md
- 会话生命周期与恢复：../ai-coding-agents-sessions/SKILL.md
- 终端 REPL 交互设计：../ai-coding-agents-terminal-ui/SKILL.md
- 智能体运行时之外的通用 CLI 设计：../software-devtools/SKILL.md