用途:为 Claude Code 与 Codex 两个运行环境编写、审查或现代化同一份可移植的智能体技能,避免把两者不同的模型与运行时行为压缩成含糊建议。共享的 SKILL.md 定义任务契约;仅限某一运行环境的调用方式、元数据、钩子、权限与路径特性保留在适配器或安装文档中。
主要能力:区分审查请求(只给结论、不改文件)与创建、改进、现代化请求(授权进行范围内的编辑);明确两个目标(Claude Code 配对应的 Claude Fable 模型,Codex 配对应的 GPT-5.6 系列模型),并记录不可用的组合;先写可移植核心,只保留领域知识、脆弱流程、权限边界、证据要求、输出保留和真实的停止或回退规则;当另一运行环境无法以相同含义解释某能力时,将其移入适配器,核心在缺少适配器时仍须正确完成。
必要用法:先读 references/model-prompting-contract.md 了解共享提示契约与模型专属行为,使用路径、调用语法、工具名、frontmatter 键、钩子、子智能体特性或环境变量前读 references/harness-portability.md,审查新包或已有包时参照 references/review-gate.md。可移植核心中只保留 name 与 description frontmatter、正斜杠相对资源路径等通用写法;/skill-name、$skill-name、.claude/skills、.agents/skills、${CLAUDE_SKILL_DIR}、context: fork、allowed-tools、agents/openai.yaml 等属适配器专属。
适用场景:需要在两类运行环境复用的技能包编写与维护。限制:需在两个目标环境用相同夹具与评分标准做行为评估,结构校验不能替代行为测试,Claude Code 通过不代表 Codex 通过;文中未提供具体价格、安装命令或平台信息。