Goalcraft Skill

Goalcraft

TL;DR：读需求 + 探仓库 → 选模板 → 🔴 必要时 STOP → 只输出填实的 /goal YAML → 过 G1–G6 验收门。不执行任务、不写默认时限。

一句话需求 + 目标仓库实况 → 可粘贴 /goal。缺路径/命令/验收/权限时，先收成契约再交给执行会话。

> 资源分册： > [templates.md](references/templates.md) · [field-spec.md](references/field-spec.md) · [stack-infer.md](references/stack-infer.md) · [examples.md](references/examples.md) > 安装路径见 README「快速开始」（随 Agent Skills 兼容 runtime 而异，本文件不绑定某一目录）。

五条原则

| # | 原则 | 说明 | |---|------|------| | 01 | 只产 goal | 不替用户跑重构/发版/清洗 | | 02 | 实例化 | 禁止留下 `；命令来自目标仓 | | 03 | **可观察成功** | success_criteria 必须机器或人工可核对 | | 04 | **权限前置** | 外部系统写入 needsauth；依赖权限步骤标 manual: | | 05 | **默认无时限** | 不写 budgetlimit_minutes`，除非用户原文明确要求 |

工作流

探查 intent/stack → 选模板 → 🔴 CHECKPOINT → 输出 /goal YAML → 自检

Step 1 · 短探查

| Step | 输入 | 动作 | 输出 | |------|------|------|------| | 1 | 用户原文 | 抽目标、路径、禁止项（不抽时间预算） | intent | | 2 | 目标仓库 | 按 [stack-infer.md](references/stack-infer.md) 推断包管理/命令/CI | stack | | 3 | intent+stack | 选 [templates.md](references/templates.md) 最近模板；禁止硬套无关场景 | template_id 或 generic | | 4 | 外部系统 | CI/云/CMS/DB/token；未确认 → needs_auth | 列表或空 |

能推断的不要问；否则最多问 1–3 个关键 inputs。

Step 2 · 失败模式（按表执行）

| 触发 | 一线修复 | 仍失败兜底 | |------|----------|------------| | 无路径且多模块 | git status/近改目录猜 1 候选并确认 | target_paths: [] + constraints 写待确认 | | 模板不清 | 通用骨架；title 用用户动词 | 禁止硬套发布/博文等 | | 包管理不明 | lockfile→npm/pnpm/yarn；读 manifest scripts | short_test 用 README 命令 + 注明未确认 | | shorttest 命令不存在 | 换 [stack-infer.md](references/stack-infer.md) 实 script | 降级 ls/git status+人工冒烟；禁抄模板里的假命令 | | 需外部权限未声明 | 补 needs_auth；success 写「鉴权后再跑」 | 权限步骤标 manual:，禁止假绿 | | 仍有 ` | 回填或 TBD:字段 写入 constraints | **禁止**交付含 ；改问用户 | | 用户未提时限 | **不写** budgetlimit_minutes`，不问「预算多久」 | 仅当用户原文含明确时限才原样写入 |

Step 3 · 🔴 CHECKPOINT · 🛑 STOP

任一条成立 → 先问用户，禁止静默交付：

1. target_paths / source / repo 仍空且用户未确认候选
2. 发布/外部写入字段缺失（release_type / ci_provider / CMS / DB）
3. 「重构」与「改行为/加功能」冲突
4. 多轨任务未标明先后 → 问清顺序，或默认写入 constraints（例：先审计后美化）

用户确认或说「你定/按默认」后进入输出。 禁止因「没给时间」而 STOP；禁止默认写入 budget_limit_minutes。

Step 4 · 输出格式（唯一交付）

默认只输出下列 YAML（用户要说明时附 ≤5 行）：

/goal
title: 
inputs:
  repo: .
  # 场景字段全部实值，禁止 
constraints:
  - 
  # 禁止写 budget_limit_minutes（除非用户原文明确要求时限）
success_criteria:
  - 
common_failure_modes:
  - 
short_test:
  - shell: |
      
deliverables:
  - 
needs_auth:  # 可省略
  -  — 

字段语义 → [field-spec.md](references/field-spec.md)。

交付验收门（输出前必须全过）

| 门禁 | 通过条件 | 失败动作 | |------|----------|----------| | G1 无占位 | YAML 中无 ` angle 括号 | 回填或 🔴 问用户 | | G2 命令真实 | shorttest 每条命令能在目标仓 package.json/README/lockfile 对上号 | 按 [stack-infer](references/stack-infer.md) 重写 | | G3 可观察 | successcriteria ≥1 条可核对（退出码/文件/tag/CI 名） | 改写为可观察句 | | G4 权限诚实 | 需要外部权限的步骤有 needsauth 或 manual: | 补声明，禁止假绿 shell | | G5 无擅自时限 | 无 budgetlimit_minutes，除非用户原文写了时限 | 删除该字段 | | G6 只产 YAML | 正文默认只有 /goal` 块（说明 ≤5 行） | 删掉长文解释 |

Step 5 · 场景选型

| 关键词 | 模板 | |--------|------| | 重构 / 抽公共 / 无行为变化 | 1 | | 发版 / changelog / tag / 制品 | 2 | | 清洗 / 幂等 / quarantine / ETL | 3 | | 简报→博文 / SEO | 4 | | 修测试 / 红转绿 / flake | 5 | | 升依赖 / lockfile / audit | 6 | | 审计 / UI 检查 / 多 skill 串联 | 通用骨架 |

选型冲突时：用户动词优先于关键词表；同时命中多个模板 → 用通用骨架并在 constraints 写清阶段顺序。

骨架全文 → [templates.md](references/templates.md)。

Step 6 · 写完自检

• [ ] 无 `` 占位（除非用户要求留空）
• [ ] 无 budget_limit_minutes（除非用户原文明确要求时限）
• [ ] short_test 可跑或已标 needs_auth / manual
• [ ] ≥1 条可机器核对的 success
• [ ] deliverables 可验收
• [ ] 行为不变任务写明禁改 public API / I/O / 对外契约

反例黑名单

| 禁止 | 正确做法 | |------|----------| | 执行 goal 内重构/发版/清洗 | 只交 /goal YAML | | 照抄模板里的 pnpm / dist / 虚构 CI | 按目标仓 [stack-infer](references/stack-infer.md) 填实命令 | | 留下 angle 占位 | 填实或 🔴 先问 | | 无路径默认全仓重构 | 确认 1 路径或 target_paths: [] | | 「加功能」写成无行为变化重构 | 换骨架或改 title/constraints | | 长文压过 YAML | 默认只输出 YAML | | 省略 needs_auth 却写需权限的 shell | 声明权限；标 manual | | 改 templates「顺便优化」语义 | 只实例化字段，不改模板库含义 | | 擅自加时限 / 因无预算而追问 | 默认不写时限 |

使用提示（可附在 goal 末尾一行注释）

# 补齐 inputs → 交执行 agent；稳后可定时/Webhook。外部权限开头声明。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: xiaoyangtx996
• Source: xiaoyangtx996/goalcraft-skill
• License: MIT

Install and usage instructions live in the source repository linked above.