SuperAPI AI 工具集

cross-harness-skills

智能体与模型

查看项目

更新于 10-15 21:52

技能介绍

用途:帮助构建一个可移植的技能核心,使其在 Claude Code 与 Codex 中都能工作,同时不把两者不同的模型与运行时行为简化为模糊建议。共享的 SKILL.md 定义任务契约;仅属于某一 harness 的调用方式、元数据、钩子、权限和路径特性应放在适配器或安装文档中。

主要能力:区分仅审查请求(只返回发现、不编辑文件)与创建、改进或现代化请求(授权范围内编辑);识别每个 harness 中确切的目标模型,区分 GPT-6.1 Sol 与旧版 GPT-6 Sol,不因指南提及就替换模型;记录不可用组合,不把一次成功运行当作两者都通过的证据。

使用方式:先分类请求;从请求和适用路由策略确定目标模型;阅读 references/model-prompting-contract.md 获取共享提示契约与不得泄漏进领域技能的模型特定行为;在使用路径、调用语法、工具名、frontmatter 键、钩子、子代理功能或环境变量前阅读 references/harness-portability.md;先写可移植核心,只加入领域知识、脆弱流程、权限边界、证据要求、输出保留和真正的停止或回退规则;当另一 harness 无法以相同含义解释某能力时,将其移入适配器,核心在没有该适配器时仍须正确完成;对包及其直接链接资源应用 references/review-gate.md;在变更模式下修补实测缺陷,不重写已通过的技能去提及模型名;验证打包与变更的可执行资源;仅在请求时运行模型对比,可复用已有轨迹,并区分静态发现与在任一 harness 中实际执行的行为。

适用场景:需要一份技能同时服务 Claude Code 与 Codex,或需要审查、现代化此类跨 harness 技能包时。

限制:可移植不等于模糊,须保留精确领域契约与确切安全或模式规则;不要把两份模型指南的每条建议都复制进核心,只保留任务特定交集并隔离分歧的运行时控制;XML 提示结构可能有助于复杂 Claude API 模板,但不是通用文件系统技能要求;不要依赖仅 Claude 的元数据保护副作用,也不要依赖仅 Codex 的策略使工作流安全;当难点仍是上下文判断时不要添加包装脚本;更小的候选只有在所需行为与证据仍通过后才胜出。评估仅在用户明确请求时运行,不是普通技能工作的前提。