TrailNote readiness
- Landing copy: reviewed.
- Checkout: not tested. Payment success remains unknown.
Next action: obtain an actual checkout test result before making a payment claim.
真實產出 · 已記錄檢查
真實樣例 · Markdown
# TrailNote readiness - Landing copy: reviewed. - Checkout: not tested. Payment success remains unknown. Next action: obtain an actual checkout test result before making a payment claim.
写一个带两条验收標準的需求让 agent 完成，然后逐条对照打勾。
已記錄真實任務成果與檢查；實測範圍見證據
- 验收逐条通过，或你准确指出哪条没过、为什么
- 过程中没有出现三轮以上的返工
目前公示 1 個樣例，不代表所有輸入均已驗證。請在實際使用時核對事實與數據。
了解自測標準
樣例內容原樣呈現，僅做閱讀排版
下載完整樣例
運行方式
Codex
由你的 Agent 執行，模型用量由服務商計費
實測環境：
Agent／模型費用依供應商而定；額外服務與依賴詳見完整包。
Node.js 18+ for optional checks
Node.js 18+ for optional checks
主線哪幾關用到它
Skill 是一把武器，配合新手主線實操，打通從「會玩」到「精通」的打怪升級全流程。
帶著這次成果繼續: 给 agent 一份專案說明書 →
✓ 適合誰 (Good Fit)
- 沿主線動手學習的 AI 新手
- 從對應關卡開始；頁面瀏覽不會被當成任務完成。
⊗ 不適合誰 (Not For)
- 超出本次任務的無人值守操作或未核准的帳號存取
✦ 你會得到 (What You Get)
- 学会写带验收標準的需求，摆脱反复返工
- 验收逐条通过，或你准确指出哪条没过、为什么
- 过程中没有出现三轮以上的返工
交付內容：完整 SKILL.md 規則文件 + 公開自測樣例。需要在你自己的 AI Agent 中運行。
怎麼開始？
Skill 是一份教 AI 完成任務的規則。
1
提供手上的材料
写一个带两条验收標準的需求让 agent 完成，然后逐条对照打勾。
2
讓 Agent 按規則完成
学会写带验收標準的需求，摆脱反复返工
3
打開並核對真實產出
验收逐条通过，或你准确指出哪条没过、为什么
發給你的 AI Agent
用 prompt-spec 帶我完成這一關。缺少材料先問我，實際使用工具並儲存結果，再按關卡判據核對。
從這裡開始使用
压缩包里是规则、参考库、脚本、真实产出和演示片，不只是一个提示词文件。
- 打開 Codex 或 Claude Code，粘貼安裝提示詞。
- 讓 Agent 讀取並保存完整規則，確認安裝成功。
- 複製上方使用示例，換成你的素材開始運行。
手動安裝 · 查看完整 SKILL.md（56 行）
Codex：~/.agents/skills/prompt-spec/SKILL.md
Claude Code：~/.claude/skills/prompt-spec/SKILL.md
---
name: prompt-spec
description: Turn a beginner's concrete request into an executable task with observable acceptance criteria, then perform it and reconcile each criterion to the saved result. Use when the learner needs to stop guessing what counts as done.
---
# Agree what done looks like
Main quest 2-1. Bring a real small task; a polished instruction alone is not the final result.
## Before acting
Identify the desired outcome, source material, selected working folder and destination.
Ask only about a missing detail that changes the result. Offer a harmless practice example if the learner has no material.
Write a short task contract with goal, input, output and two or more acceptance criteria.
Make criteria independently observable: exact facts, an opened file, a preserved section, or a reproducible check.
Avoid criteria such as “professional”, “perfect” or “good quality” without a concrete meaning.
Separate a requested action from authority to send, spend, publish or access accounts.
## Perform and reconcile
Use actual tools to complete the agreed task in a new output location.
Read the saved result. For each criterion record PASS, FAIL or UNKNOWN and cite its evidence.
A failed or unknown criterion is still useful information; never mark it passed to complete a checklist.
If a revision is needed, keep the contract and change only the failed part.
Record the number of actual revision rounds; do not promise an arbitrary success rate.
After three unsuccessful rounds, summarize the concrete blocker and the smallest missing decision.
Do not change the goal silently to make the checks pass.
## Contract and optional check
Use `references/task-contract.json` as a shape, not as the learner's requirements.
Save the result separately from the checklist.
The optional checker verifies that a recorded criterion cites real, nonempty evidence under the selected evidence folder:
```text
node <skill>/scripts/check-contract.mjs <contract.json> <evidence-folder>
```
It checks the record, paths and quoted evidence. It cannot judge subjective quality or independently confirm a user's statement.
Only use PASS for a criterion you actually examined. Keep uncertainty visible.
## Self-tests and failure criteria
1. Use `inputs/brief-a.md`: create a two-item publication readiness note. Preserve the exact names and leave untested payment unknown. Save the contract, result and checks.
2. Use `inputs/brief-b.md`: produce a compact Chinese preparation note with the supplied date and quantities unchanged. This is a separate input, not a translation of test one.
3. With no brief, ask for goal and source material; do not invent a business or a deadline.
4. Change a quoted fact in the evidence after the check was recorded. The bundled checker must reject the stale quote.
An invented fact, an unperformed criterion, evidence outside the selected folder or an unannounced scope change fails the task.
## Continue
Return to `/path/prompt-spec/`.
Next `/path/project-context/`: keep the conventions that recur in a short project instruction file.
Free main quest Skill. Original workflow; personal and commercial use permitted, no complete-package resale.
新手常問 (FAQ)
有疑惑？先看看這裡，買前明明白白，用時順順利利。
怎麼開始？
下載完整 ZIP，把安裝提示交給 Agent，保留腳本與參考檔案。模型費用另計。
主線 Skill 免費嗎？
這些基礎主線 Skill 免費；進階工作室商品沿用各自定價。