该技能用于设计或评审编码智能体 CLI 的两个注册表:工具运行时与斜杠命令运行时。工具运行时涉及工具契约、工具池组装、延迟加载、ToolSearch、执行流水线与远程结果渲染、子智能体调度;命令运行时涉及类型化命令种类、按来源发现、懒加载、fork 命令与远程安全调度。两者都强调来源、优先级、暴露前过滤、拓扑变更后刷新以及单一执行路径,并使用统一的契约词汇,避免权限、遥测与渲染语义分叉。
适用场景:为编码智能体运行时或 REPL 设计工具注册表或斜杠命令注册表;添加内置、MCP、插件、技能或工作流提供的工具与命令;建模工具结果渲染、进度事件、中断行为;决定哪些工具应延迟到工具搜索之后;区分桥接安全、远程安全与仅终端命令。
核心约定:每个注册表对所有来源使用同一接口;kind 与 origin 显式声明;暴露前过滤(被拒绝、模式隐藏或不可用条目不进模型);静态可用性与动态启用分离,调度时复查并以类型化原因失败关闭;拓扑变更后经由单一刷新路径重建可见集合;名称冲突用显式逐来源对策略解决并记录遮蔽事件;远程未知条目降级为可渲染桩。
工具运行时流程:定义工具契约(执行、校验、权限、渲染、中断位于工具类型上);由内置与外部工具经单一函数组装工具池,依赖提示缓存时将内置保持为稳定前缀;显式标记延迟与永不延迟;ToolSearch 与执行分离,发现后重新确认可调用性;执行流水线显式分为校验、权限检查、遥测、钩子、执行、结果整形、持久化与渲染。
命令运行时流程:分类命令表面(提示展开、本地文本、本地 JSX/TUI、全屏跨会话管理器);定义类型化注册表契约;显式建模加载顺序并按规范文件身份去重;懒加载,加载失败只降级单条命令;决定模型可调用性;以显式白名单门控远程与桥接执行;将 fork 命令视为带显式工具与上下文继承的子智能体编排;记忆化发现需宿主拥有的失效路径。
限制:该技能只负责工具与命令架构,不负责审批策略与沙箱、插件打包、会话持久化、MCP 服务器设计或更广架构,这些由相关技能承担。仅当存在多个独立加载来源、远程或桥接客户端、或模型可调用命令时才使用完整命令契约;单一来源、仅终端的少量静态命令用扁平匹配即可。模板与参考文件见 assets/templates/minimal-command-registry.ts 与 references/ 下各文件。