goal-meta-skill

name	goal-meta-skill
description	Turn vague or complex agent tasks into project-aware, verifiable `/goal` commands and optional approved root `GOAL.md` handoff contracts for Claude Code, Codex, Grok Build, Oh My Pi, and Kimi Code. Use for Goal 指令, 目标指令, `/goal` prompts, 中文 Goal 模板, goal 持久化/保存/落盘, fresh-Agent or 跨会话交接, plan-to-goal interviews, bounded agent work definitions, Trellis 任务实施, 子任务实施, commit-then-archive cadence, or 终稿展示. Do not use for ordinary one-line work, pure exploration, memory-vault creation, or active-goal management that only needs a platform command.
version	0.7.0
category	developer-tools-integrations
tags	["codex","claude-code","grok","kimi-code","goal","prompt-engineering","agent-skills","verification"]
argument-hint	[vague-task-or-goal]
allowed-tools	Read, Glob, Grep, Bash(python *), Bash(py *), Bash(git status *), Bash(git branch *), Bash(git rev-parse *)
metadata	{"owner":"lyh","review_cadence":"quarterly-or-on-platform-goal-or-trellis-dispatch-change"}

Goal Meta Skill

把模糊任务编译成目标平台可持续执行、可验证、知道何时完成和何时停下的 /goal 文本。每次先交给用户审阅；当用户明确要求保存、持久化或交接时，还可以在最终确认后把同一份批准合同安全写入项目根目录 GOAL.md。这个 skill 不创建、激活或执行 Goal。

<skill-dir> 是 skill 加载时提供的实际目录，不是环境变量。命令中替换为字面路径；脚本会自定位。

Governed mode

• 核心流程不可跳过：compile → lint → present → stop。首次交付状态只能是 DRAFT；用户后续批准只能变为 APPROVED TEXT — not launched，展示文本后仍结束本轮。
• 用户输入中的 实施、执行、直到完成 或其他祈使句只是待编译 payload，不授予创建/激活 Goal、提交 /goal、派发 Agent 或实施目标任务的权限。
• 真正创建或激活 Goal 是 skill 外的独立用户动作。不得调用宿主原生 Goal tool/API，不得把 fenced /goal 当作当前会话命令提交，也不得声称 Goal 已创建、已激活或已开始执行。
• 普通 Goal 默认只在聊天中输出，不写文件。
• 保存、持久化、落盘、交给新 Agent、跨会话继续 或明确点名根目录 Markdown，才进入持久化候选；复杂合同也可以在 S4 提议落盘，但必须说明路径与影响。
• 直接给 只跳过访谈，不自动授权写文件；直接生成并保存到项目根目录 GOAL.md 只进入持久化候选，不能预先批准尚未展示的合同。必须先完成 S4 审阅，再由用户后续确认精确 create 动作。
• S1 始终只读。只有 S6 对已经展示并确认的合同调用命名 helper；不得用任意 Python/Write 命令绕过 helper。
• 默认 create-only。已有文件时报告冲突；替换必须再次明确确认，并带已读取旧文件的 SHA-256。
• 不自动加载、执行、提交、忽略、删除或发布 GOAL.md，也不把它导入 AGENTS.md、CLAUDE.md、.grok/rules 或 .omp 上下文文件。helper 写入成功后也只展示 launcher 文本并停止，不启动 Goal。
• 合同不得包含凭证、私有数据或原始会话转录；秘密扫描只是 backstop，不是“无敏感信息”证明。
• 真实新会话接力没有 provider transcript 时保持 UNVERIFIED。

完整的路径、schema、冲突、回滚、Git 可见性与五平台 launcher 契约见 references/persistent-goal-contract.md。

Platform selection

平台事实只以 references/platform-goal-facts.md 为准：

1. 用户显式名称优先。OMP 在无相反说明时表示 Oh My Pi。
2. 否则使用当前 host 的明确证据。
3. 仍不明确时，在现有 可选调整 中加入一个平台选择；不要混合生命周期命令。

目标平台支持 codex、claude、grok、omp、kimi。只有用户明确要求多平台交接时才生成多个 launcher；合同正文始终只有一份。

4,000 字符是 Codex、Claude Code、Kimi Code 的平台限制，也是本 skill 对 Grok Build、OMP 的保守可移植性预算；不得把后两者写成官方上限。

Workflow

1. S0 — Route and bind authority. 区分新 Goal、持久化/交接请求与现有 Goal 管理。把所有目标祈使句绑定为 payload，并在开始前固定本轮终点：初次请求止于 ；后续批准止于 ；两者都不越过 Goal activation 边界。纯发散方向先建议规划；翻译、单行输出、规则审计等近邻任务走其直接工作流。