---
id: spec
term: Spec
zh: 規格
category: handoffs
layers: [L3, L4]
course_days: [day2, day3]
learning_stages: [level3, level4]
related_terms: [ticket, skill, handoff-artifact]
source_inspiration:
  - mattpocock/dictionary-of-ai-coding
status: draft
---

# Spec - 規格

## 一句話

Spec 是把需求轉成可執行、可檢查、可交付規格的文件或描述。

## 不要誤會成

它不是靈感、願望或一句功能名稱。

## 為什麼重要

Spec 是人類意圖與 Agent 執行之間的橋樑，越清楚越能減少來回修正。

## 在五層模型的位置

主要對應 L3 Skill 與可重複工作流層、L4 Agent 協調層。理解它可以幫助你判斷問題發生在五層模型的哪個位置。

## 課程中會出現在哪裡

這個術語會出現在 Day 2 AI 工具的選擇與搭配、Day 3 把自己的工作方法交給 AI 協作，用來幫助學員把實作經驗連回 AI 工作系統的概念。

## Agent 需要注意什麼

開始實作前要確認目標、非目標、輸入輸出、狀態、錯誤情境和驗收標準。

## 情境例句

> 「我想做一個互動式課程頁，這樣夠清楚嗎？」
>
> 「還不是 spec。spec 要說清楚頁面、狀態、輸入、輸出、限制、驗收標準和不能破壞的既有行為。」

## 常見錯誤

- 把願望清單當成規格。
- 沒有定義完成標準。
- 沒有標明非目標和風險。

## 相關術語

- [Ticket](ticket.md)
- [Skill](skill.md)
- [Handoff Artifact](handoff-artifact.md)