用途:把模糊或复杂的智能体任务编译成目标平台可持续执行、可验证、知道何时完成与何时停下的 /goal 文本。它不创建、激活或执行 Goal,真正启动是技能外的独立用户动作。
主要能力:受控流程为 compile → lint → present → stop,首次交付状态只能是 DRAFT,用户批准后为 APPROVED TEXT — not launched。支持 codex、claude、grok、omp、kimi 五平台渲染;普通模式只在聊天输出,不写文件。当用户明确要求保存、持久化、交接或点名根目录 Markdown 时,才进入持久化候选,经确认后用 helper 写入根目录 GOAL.md,默认 create-only,已有文件需再次确认并带旧文件 SHA-256。
使用方式:先做只读侦察(读取局部规则、真实命令源,运行 git rev-parse --show-toplevel、git branch --show-current、git status --porcelain -uall),再按需访谈,随后给出完整无占位符的合同并停止。持久化写入命令:python "<skill-dir>/scripts/persist_goal_contract.py" --repo-root "<confirmed-root>";替换加 --replace --expected-sha256 "<observed-sha256>"。校验命令:python "<skill-dir>/scripts/lint_goal_command.py" --platform codex <file>,持久合同额外加 --contract --expected-path GOAL.md。Windows 可用 py -3。
适用场景:需要把模糊任务转成可验证目标、跨会话交接、或生成平台 launcher 的场合。限制:不调用宿主 Goal tool/API,不提交 slash command,不派发 Agent,不自动加载、提交、忽略、删除或发布 GOAL.md;合同不得含凭证、私有数据或原始会话转录;4,000 字符为 Codex、Claude Code、Kimi Code 平台限制,对 Grok Build、OMP 仅为保守预算。Trellis adapter 仅在 outcome 明确为 Trellis 任务时加载。其余细节暂未提供。