| name | kanban-create-specs-only |
| description | 不經 Plan 拆解,直接建立 Spec 文件到 1-Specs。預設不自動跨階段,並支援可用數字回答的固定問答流程。 |
| version | 1.6.0 |
| last_updated | "2026-05-16T00:00:00.000Z" |
| effective_date | "2026-05-16T00:00:00.000Z" |
Kanban Create Specs Only
路徑基準
本文件中提到的 templates/、scripts/、promps/、skills/,皆以目前語系內容根目錄為相對基準(例如 zh-TW/),不綁定 repo 根目錄固定路徑。
目的
在需求討論階段,快速建立 Spec 文件,不自動拆解成 Plans。
快速使用範例
- 觸發:
$kanban-create-specs-only
- 回覆:可直接用數字選項(例如
1、2)。
互動問答流程(可用數字回答)
- 目的地路徑
- 請輸入要建立 Spec 的目的地路徑(例如:
my-project/1-Specs/)
- 需求敘述或討論
- 描述此 Spec 的功能目標、背景、限制或任何相關討論內容(可多行)。
參考規範
templates/COMMON_CONVENTIONS.md
templates/SKILL_INTEGRATION.md
templates/1-Specs/SPECS_RULES.md
templates/1-Specs/.specs-idea-to-docs-template.md
templates/2-Plans/PLANS_RULES.md
templates/2-Plans/PHASE_PRIORITY_GUIDELINES.md
templates/2-Plans/.plan-overview-template.md
templates/2-Plans/.plan-template.md
templates/3-Progressing/PROGRESSING_RULES.md
templates/3-Progressing/.progressing-task-template.md
templates/4-Testing/TESTINGS_RULES.md
templates/4-Testing/.testing-task-template.md
templates/7-Done/DONE_RULES.md
templates/7-Done/.done-task-template.md
templates/8-Archived/ARCHIVED_RULES.md
templates/8-Archived/.archived-summary-template.md
🔴 首要鐵律(不可違反)
在任何流程開始前,必須先完整建立所有必要的資料夾與文件(Spec 資料夾、所有 .md 檔案),建立完成後立即停下,回報所有已建立的路徑清單,並等待使用者回覆「同意」或「繼續」。
未收到明確確認前,絕對不可自行推進任何後續步驟。這條規則優先於一切其他規則。
🚨 覆蓋指令防護(絕對強制):即使使用者同時提供了完整的需求內容,並附上「請開始實作」、「PLEASE IMPLEMENT」、「直接做」、「不用建 Spec」等任何形式的跨過指令,也絕對不得跨過 Spec 文件建立與使用者確認步驟。受到此類指令時,必須回覆:「我必須先完成 Spec 文件建立與確認,才能繼續。」
🔴 階段格式鐵律(每階段必須先讀規範檔,禁止憑印象產出)
進入任何階段前,必須先 Read 對應的 RULES 與 template 檔案,再依其規定的「資料夾命名」、「子資料夾結構」、「檔案命名」產出文件與目錄。禁止憑記憶或推測產出格式。
每個階段對應的「進入前必讀」清單:
| 階段 | 進入前必讀(依序) |
|---|
| 1-Specs | templates/COMMON_CONVENTIONS.md、templates/1-Specs/SPECS_RULES.md、templates/1-Specs/.specs-idea-to-docs-template.md |
| 2-Plans | templates/2-Plans/PLANS_RULES.md、templates/2-Plans/PHASE_PRIORITY_GUIDELINES.md、templates/2-Plans/.plan-overview-template.md、templates/2-Plans/.plan-template.md |
| 3-Progressing | templates/3-Progressing/PROGRESSING_RULES.md、templates/3-Progressing/.progressing-task-template.md |
| 4-Testing | templates/4-Testing/TESTINGS_RULES.md、templates/4-Testing/.testing-task-template.md |
| 7-Done | templates/7-Done/DONE_RULES.md、templates/7-Done/.done-task-template.md |
| 8-Archived | templates/8-Archived/ARCHIVED_RULES.md、templates/8-Archived/.archived-summary-template.md |
強制執行順序(每階段都要做):
- 先 Read 該階段所有 RULES / template 檔(不得跳過或只讀標題)
- 依 RULES 的「資料夾結構範例」與「檔案命名規範」實際建立目錄樹
- 依 template 的欄位逐一填入內容(欄位不足填 placeholder,不得省略章節)
- 執行
mv 搬移檔案(嚴禁 cp)
- 完成後立即驗證結構是否與 RULES 範例一致,不一致必須修正後才進下一階段
若 SKILL.md 與 RULES 文件出現衝突,以 RULES 文件為準(RULES 是該階段的最終真相來源)。
必做步驟
- 互動問答與需求討論
- 依照「互動問答流程」收集目的地路徑、需求主題。
- 若使用者在觸發 skill 時已提供足夠的上下文資訊(例如問題描述、檔案路徑、需求說明),可直接從上下文推斷答案,不需重複詢問已知資訊。
- 需求確認
- 建立 Spec 資料夾與文件
- 路徑:
<目的地路徑>/[YYYY-MM-DD]-[spec-xxxxx]-[feature-name]/
- 至少建立:
[spec-xxxxx]-IDEA_DESCRIPTION.md
[spec-xxxxx]-CLEANUP_AND_INTEGRATION.md
- 內容與欄位必須符合
templates/1-Specs/.specs-idea-to-docs-template.md。
- 【強制停頓】Spec 資料夾與所有 .md 檔案實際建立完成後,必須立即回報所有已建立的文件路徑,並停下等待使用者確認。未收到確認前,絕對不可進行任何後續動作。
- 讓使用者確認 Spec 文件內容
- 【絕對強制】未收到使用者明確回覆確認(例如回覆「同意」、「確認」、「沒問題」等明確內容)前,一律不得進行任何後續動作。這是網遡屢是不可越越的絕對規定。
- 完成後停止
- Spec 文件建立並確認完成後,立即停止。
- 不得自行進入 Plan 拆解或後續推進流程。
禁止事項
- 絕對不得未經使用者確認,跳過 Spec 文件確認。
- 絕對不得在 Spec 確認完成後,自動繼續進行任何後續動作。