Matt Skills with To-Goal

把任务边界写清楚，其余交给模型：能继承就 Fork，要搬运就 Goal

一组可以独立安装、按需组合的 Agent Skill。它们稳定任务合同、权限和证据，不规定模型必须用哪套思考或工程流程。

any approved source → optional goal or fork → evidence returns

▶ 在线故事版：别让一个线程从需求聊到代码写完

它解决什么问题

AI coding 任务常常从需求讨论一路聊到代码实现。线程越长，上下文越容易膨胀、压缩和变慢；但直接开新线程，又担心缺少需求背景和已经确认的决策。

这套技能提供几个松耦合边界。它们可以组合，但没有固定流水线：

Fork 负责隔离后续上下文，Goal 负责压缩已有上下文。 两者都是可选能力，不要求先运行 grilling、to-spec、to-tickets、TDD 或 code-review。

30 秒看懂组合方式

flowchart LR
    source["已批准的来源<br/>对话 / Spec / Issue / 文档"]
    source -->|"上下文清晰"| fork["可选 Fork"]
    source -->|"需要搬运或压缩"| goal["可选 /to-goal"]
    fork --> execute["/spec-executor"]
    goal --> agent["任意执行 Agent"]
    execute --> receipt["证据回执"]
    agent --> evidence["完成证据"]

    classDef source fill:#171717,color:#F7F3EA,stroke:#171717,stroke-width:2px;
    classDef plan fill:#F7F3EA,color:#171717,stroke:#171717,stroke-width:2px;
    classDef contract fill:#DCF23E,color:#171717,stroke:#171717,stroke-width:3px;
    classDef action fill:#F35B2A,color:#FFFFFF,stroke:#171717,stroke-width:2px;

    class source source;
    class fork,goal contract;
    class execute,agent action;
    class receipt,evidence plan;

来源只要已经明确范围、完成标准和权限即可，不需要带特定 Skill 的标记。模型可以自行选择规划、实现、测试和评审方法；已有专项 Skill 或工具时可以使用，没有时也不会阻塞。

三分钟开始

1. 安装

Claude Code 可以把本仓库作为独立 marketplace 安装：

claude plugin marketplace add tt-a1i/matt-skills-with-to-goal
claude plugin install matt-skills-with-to-goal@tt-a1i

Codex 和其他支持 Agent Skills 的工具使用 skills.sh：

npx skills@latest add tt-a1i/matt-skills-with-to-goal

两种方式选一种，避免同一个 Skill 被重复加载。本仓库维护者可运行 npm run sync:local，把工作树安全同步到统一的 ~/.agents_skills/ 并刷新 Hermes。

Codex App 中的自动 Fork 闭环还需要单独安装 Codex Task Messenger。其他 harness 仍可手动 Fork 后运行 spec-executor，不影响核心执行能力。

2. 选择需要的能力

整套安装适合希望浏览完整上游目录的用户。更轻的方式是只安装需要的 Skill：

npx skills@latest add tt-a1i/matt-skills-with-to-goal --skill=to-goal

to-goal、goal-crafter 和 spec-executor 都可以独立工作。只有 execute-spec-in-fork 因为负责 Codex App 任务通信，明确依赖 spec-executor 和 Codex Task Messenger。

3. 直接使用

# 把当前已确认的工作压成可搬运合同
/to-goal

# 或把当前已确认的工作放入 Codex Fork 执行
/execute-spec-in-fork

不需要先运行初始化、访谈、Spec 或 Tickets Skill。输入尚未明确时，模型先补齐真正缺失的决策；任务过大时，它会建议拆分，但不会强制路由到某个 Skill。

Fork 与 to-goal 如何分工

• execute-spec-in-fork + spec-executor：当前线程已经把工作谈清楚，且能在一个执行会话完成；自动建立同目录执行任务和回传通道。
• to-goal：需要跨人、跨天、跨引擎、并行，或者当前历史过长、存在多版冲突；用压缩后的执行合同换取干净上下文。
• 同线程直接实现：小而明确、不值得跨上下文的改动，让模型直接完成即可。

自动 Fork 闭环拆成三层，每一层都可以单独复用：

没有 Codex App 任务工具或 Messenger 时，手动 Fork 后仍可运行 spec-executor。Executor 不绑死 Codex；Goal 更是一份可粘贴到 Cursor、Claude Code 或其他引擎的合同。

to-goal 增加了什么

to-goal 把任何已批准的工作来源进一步编译成“新线程可以直接执行的契约”。来源可以是对话、spec、issue、文档或已有代码状态，不要求来自 to-tickets。Goal 买的是可移植性：换会话、换人或换引擎之后，仍按同一份标准交付。

Goal
├── Current state       分支、HEAD、已完成证据、已知缺口
├── Execution order     最短的依赖顺序
├── Completion criteria 可逐条判断 done / not done 的标准
├── Constraints         范围、权限、脏文件与外部操作边界
└── Context             spec、ticket、设计文档和验证入口

默认每个 frontier ticket 一份 Goal。互不阻塞的切片可以分别交给不同 Agent，在独立 branch / worktree 里并行；to-goal 只生成合同，不创建这些执行环境。

goal-crafter 有两种模式：

• Standalone：用户直接要求编写 goal，先澄清任务、位置、完成标准、约束和执行环境。
• Compiled handoff：直接读取任意已批准的规划证据和仓库状态，不重新访谈。

如果上游材料缺少关键产品决策，compiled-handoff 模式会指出 source 尚未 agent-ready，而不是在实现线程里重新开始需求讨论。

可选入口

技能地图

仓库保留 30 个 promoted Skills 作为可选目录，不代表推荐全部安装或按顺序使用。25 个来自上游；本 fork 新增 to-goal、goal-crafter、spec-executor、execute-spec-in-fork、roundtable。fork 自有的 Goal 与执行 Skill 除了明确声明的工具依赖外，都能独立使用；上游 Skill 保留各自原有风格。

规划与交接

实现与质量

工程理解与其他

设计边界

• 默认一个 goal 只覆盖一个 frontier ticket；--all 仅用于明确要求的跨 ticket 持久化执行。
• spec-executor 只执行一个已封版、单会话可完成的 Spec；需求未定或体量溢出时停止并重新路由。
• execute-spec-in-fork 是 Codex App 的事件驱动适配器，依赖原生任务工具与 Codex Task Messenger；不会启动 daemon、自动重试或跨 Worktree 通信。
• to-goal 只读 spec、tracker 和仓库证据，不实现、不改 issue 状态、不创建分支。
• Fork 只隔离对话，不隔离文件系统；并行实现仍需独立 worktree、分支和文件所有权。
• goal 不会默认授权 push、PR、merge、关闭 issue 或修改 tracker。
• 验证强度跟随任务风险；低风险改动不机械要求全量测试，高风险逻辑必须覆盖对应验证面。
• handoff 不是每次切线程的必选步骤。只要上下文已进入 spec、ticket、评论和代码，新线程可以直接重建理解。

来源与许可

本仓库基于 mattpocock/skills main v1.2.3（同步至 2026-09-04，3cca18b），并叠加自动 fork execution、to-goal 两条上下文边界流程与 roundtable 多视角决策辩论。

当前 fork 发行版为 1.2.3-to-goal.2：前半段表示同步的上游版本，后缀表示本仓库自己的发行序列。Claude 插件、package metadata 和安装入口均使用独立身份 matt-skills-with-to-goal，不会覆盖上游的 mattpocock-skills。

• Matt 原版技能：© Matt Pocock，MIT
• 本仓库扩展与适配：MIT
• 完整许可见 LICENSE

与上游的差异

• 新增 skill：to-goal、goal-crafter、spec-executor、execute-spec-in-fork、roundtable（均位于 skills/engineering/）
• 松耦合调用：Goal 与 Executor 接受任意已批准来源，不要求固定的上游 Skill；测试与评审能力按仓库和风险选择，不再硬编码 Skill 链
• 路由适配：ask-matt 增加自动 /execute-spec-in-fork、手动 fork + /spec-executor 与 /to-goal 分支及「Crossing the context boundary」章节；to-spec 追加 SPEC READY launch block
• 表达层：grilling、to-tickets、triage、setup-matt-pocock-skills 使用固定 emoji 锚点，便于扫读与按编号回复
• 产出可选性：improve-codebase-architecture 默认以 markdown 呈现候选，HTML 报告改为按需产出（离线与受限环境下不再残废）
• 绝对化表述加边界：to-spec 的 seam 数量与 resolving-merge-conflicts 的 --abort 改为「默认…除非…」句式，保留引导力但不在边缘场景误导
• 独立发行：package、Claude plugin、marketplace、changeset 和仓库链接使用本 fork 的名称、版本与远端
• 本地分发：npm run sync:local 先备份并同步 30 个 promoted Skills 到统一的 ~/.agents_skills/，再刷新 Hermes 副本
• 上游维护：npm run sync:upstream 在干净工作树上创建备份分支，并把 fork overlay rebase 到最新 upstream/main；脚本不会自动 push
• 目录结构：跟随上游 skills/{engineering,productivity,misc,in-progress,deprecated}/ 分类
• 继承边界：未被本 fork 修改的 Skill 和文档继续继承上游；发行元数据、维护脚本和本 fork 工作流由本仓库独立维护

完整的同步、备份和远端发布约定见 docs/maintaining-fork.md。