27 lines
2.0 KiB
Markdown
27 lines
2.0 KiB
Markdown
---
|
||
name: spec-execution
|
||
description: JSC plugins 共用「執行原則」：自動執行原則（簡短計畫後直接執行到完成、只在必要決策中斷）、不臆測／需人工確認、不擴及無關檔案（排除 node_modules/.git/.docs/bin/obj/第三方依賴）。當其他 skill 內文引用 spec-execution 或 /jsc-shared:spec-execution、或執行任何 JSC skill 需要共用執行原則時載入此 skill。單獨被使用者呼叫時，直接說明本規範內容。
|
||
---
|
||
|
||
# spec-execution — 共用執行原則
|
||
|
||
所有 JSC skills（code／doc／shared）的執行行為，一律遵守以下原則。
|
||
|
||
## 自動執行原則
|
||
|
||
- 除非使用者明確要求先確認，或遇到**不可忽略的必要決策**，否則各階段只需輸出簡短計畫／進度後**直接執行到完成**，不要為一般寫入、修復、留言、提交等反覆詢問。
|
||
- **已知資訊一律跳過詢問**：使用者已透過參數（如 `--tool`、`--repo`）或對話提供的資訊，不得重複確認。
|
||
- 帶 `--yes` 時更不應中斷；但各 skill 自行定義的「一定會中斷詢問的點」（破壞性高風險決策、對外不易復原的動作）**不得被 `--yes` 略過**。
|
||
- 常見必要決策：目標不明（分支／專案／檔案缺失且無法推斷）、破壞性改寫需先確認、憑證皆失敗、無法安全解衝突、需求與現況衝突需人工裁示。
|
||
|
||
## 不臆測／需人工確認
|
||
|
||
- 任何無法可靠推論或等價推論的內容，**不編造、不硬改**：以註解或回報標註「需人工確認：...」，保留原行為，繼續處理其他項目。
|
||
- 找不到目標（manifest、檔案、分支、專案）時**不臆測**、不逕自動工；詢問使用者或依 skill 定義的流程處理。
|
||
- 需求彙整只做整理與歸納，不得編造來源未提及的需求。
|
||
|
||
## 不擴及無關檔案
|
||
|
||
- 只動 skill 明文宣告的目標檔案範圍；一律排除 `node_modules`／`.git`／`.docs`／`bin`／`obj`／generated 與第三方依賴。
|
||
- 不要新增與任務無關的 helper、測試或重構。
|