Forge Skills 用于在本地 .codex/skills 目录中设计、创建、更新和验证 Codex 技能,适合在用户想新建技能、改进现有 SKILL.md,或为另一个 Codex 会话编写紧凑操作指南时使用。
用途与主要能力:把技能写成面向 Codex 会话的紧凑操作指南,将触发相关的工作流、决策与资源导航集中在 SKILL.md,把详细示例、清单、模式或长指令放入 references/ 按需加载。支持决定资源形态:仅用 SKILL.md 存放简短稳定的流程;references/ 存放需选择性阅读的详细文档;scripts/ 仅用于可重复的确定性操作或易碎命令序列;assets/ 仅用于模板、图片、样板或最终产物文件。
使用方式:先结合具体例子澄清目标,若意图清晰可按合理假设推进;仅询问会改变技能范围、位置或所需资产的信息。技能名使用小写字母、数字和连字符,长度少于 64 字符,并检查目标目录是否冲突,默认 $CODEX_HOME/skills,未设置时用 ~/.codex/skills。从零创建时优先使用本地 skill-creator 初始化器: python '<skill-creator-dir>/scripts/init_skill.py' <skill-name> --path '<skills-dir>' --resources references,scripts 先写 SKILL.md,再填充可选资源;将全部“何时使用”的触发措辞放入 YAML description,正文仅在触发后加载,使用命令式指令。添加直接支持技能的资源,删除占位文件与未使用目录,脚本需在小样本上运行测试。运行可用验证器,并人工检查触发质量、资源链接、命名与上下文是否过多,用贴近未来的提示判断技能是否真正有效。
维护 CCFA 技能族时:CCFA Handoff Mode 为 PARTIAL(推荐),遵循 metadata.ccf_skill_controls.handoff_question_mode 与 ../ccf-common/references/handoff-modes.md;保留每个 SKILL.md 中的 metadata.ccf_skill_controls,未经检查 ../ccf-common/references/routing.md、task-modes.md、handoff-modes.md 及遵循 denylist 的回退,不得添加兄弟技能跳转。若用户禁用某技能或要求仅写作行为,应将该边界直接写入编辑后的技能指令,除用户明确要求外不得削弱写作技能中的想法范围保护。新增来源应更新 ../ccf-common/references/source-registry.yaml 而非在兄弟技能中重复 URL 列表;新增浏览或证据规则需与 ../ccf-common/references/privacy-and-evidence.md 保持一致。
限制:详细文档不写入 SKILL.md,而放入 references/ 按需加载;只有可重复确定性操作或易碎命令序列才放 scripts/;assets/ 仅用于最终产物资源。若因本地依赖缺失无法运行验证器,需明确说明失败项,并按 references/design-checklist.md 执行人工检查。资料未提供具体收费、平台兼容范围或更多外部服务信息。