# Goalcraft Skill

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-xiaoyangtx996-goalcraft-skill-goalcraft-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [xiaoyangtx996](https://agentstack.voostack.com/s/xiaoyangtx996)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [xiaoyangtx996](https://github.com/xiaoyangtx996)
- **Source:** https://github.com/xiaoyangtx996/goalcraft-skill

## Install

```sh
agentstack add skill-xiaoyangtx996-goalcraft-skill-goalcraft-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 | **权限前置** | 外部系统写入 `needs_auth`；依赖权限步骤标 `manual:` |
| 05 | **默认无时限** | 不写 `budget_limit_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 命令 + 注明未确认 |
| short_test 命令不存在 | 换 [stack-infer.md](references/stack-infer.md) 实 script | 降级 `ls`/`git status`+人工冒烟；禁抄模板里的假命令 |
| 需外部权限未声明 | 补 `needs_auth`；success 写「鉴权后再跑」 | 权限步骤标 `manual:`，禁止假绿 |
| 仍有 `` | 回填或 `TBD:字段` 写入 constraints | **禁止**交付含 ``；改问用户 |
| 用户未提时限 | **不写** `budget_limit_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 行）：

```yaml
/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 命令真实 | `short_test` 每条命令能在目标仓 `package.json`/README/lockfile 对上号 | 按 [stack-infer](references/stack-infer.md) 重写 |
| G3 可观察 | `success_criteria` ≥1 条可核对（退出码/文件/tag/CI 名） | 改写为可观察句 |
| G4 权限诚实 | 需要外部权限的步骤有 `needs_auth` 或 `manual:` | 补声明，禁止假绿 shell |
| G5 无擅自时限 | 无 `budget_limit_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 末尾一行注释）

```text
# 补齐 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](https://github.com/xiaoyangtx996)
- **Source:** [xiaoyangtx996/goalcraft-skill](https://github.com/xiaoyangtx996/goalcraft-skill)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-xiaoyangtx996-goalcraft-skill-goalcraft-skill
- Seller: https://agentstack.voostack.com/s/xiaoyangtx996
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.