用戶輸入
$ARGUMENTS
在繼續之前,你必須考慮用戶輸入(如果不為空)。
範圍守衛
此指令本身的工作僅限於更新專案章程。相依的模板和指令在運行時讀取章程,因此不在此處修改。
- 將用戶輸入的每個部分分類為章程內容或是獨立、非治理的意圖。
- 如果輸入包含功能實作、程式碼生成、重構、建置或部署請求,你不得執行它們。請將其提取為延遲意圖。
- 你不得建立、修改或刪除應用程式原始碼檔案、功能路由、元件、測試、部署檔案,或與章程工作流程無關的其他產物。
- 如果不確定某個指令是否屬於章程內容,請先要求澄清再進行修改。
- 完成章程更新後,為每個延遲意圖加入一個「下一步行動」區段。列出原始意圖並建議適當的後續 Spec Kit 指令,例如
/speckit-specify,但不要實際執行它。 - 如果沒有非治理的意圖,則省略「下一步行動」區段。
執行前檢查
檢查擴充鉤子(在章程更新前):
- 檢查專案根目錄下是否存在
.specify/extensions.yml。 - 如果存在,讀取它並查找
hooks.before_constitution鍵下的條目。 - 如果無法解析 YAML 或格式無效,請不要默默跳過:告知用戶無法讀取
.specify/extensions.yml(包含解析錯誤),並且由於未檢查任何鉤子,包括任何已註冊的必要(optional: false)鉤子,然後繼續正常流程。 - 過濾掉
enabled明確設為false的鉤子。對於沒有enabled欄位的鉤子,預設視為啟用。 - 對於其餘每個鉤子,不要嘗試解釋或評估鉤子的
condition表達式:- 如果鉤子沒有
condition欄位,或該欄位為 null/空,則將該鉤子視為可執行。 - 如果鉤子定義了非空的
condition,則跳過該鉤子,將條件評估留給 HookExecutor 實作。
- 如果鉤子沒有
- 從鉤子命令名稱建構命令調用時,將點號(
.)替換為連字號(-)。例如,speckit.git.commit→/speckit-git-commit。 - 對於每個可執行的鉤子,根據其
optional標誌輸出以下內容:- 可選鉤子(
optional: true):## 擴充鉤子 **可選前置鉤子**:{extension} 指令:`/{command}` 描述:{description} 提示:{prompt} 要執行:`/{command}` - 必要鉤子(
optional: false):
發出上述區塊後,你必須實際調用鉤子並等待其完成才能繼續。以你在這個代理/會話中執行命令的相同方式執行它(調用方式可能與上面顯示的文字## 擴充鉤子 **自動前置鉤子**:{extension} 正在執行:`/{command}` EXECUTE_COMMAND:{command} 在繼續到大綱之前,等待鉤子命令的結果。{command}ID 不同,例如,技能模式代理會以/skill:speckit-...或$speckit-...的方式執行)。僅僅發出區塊並不會執行鉤子。
- 可選鉤子(
- 如果沒有註冊任何鉤子,或
.specify/extensions.yml不存在,則默默跳過。
大綱
你正在更新 .specify/memory/constitution.md 中的專案章程。有效的章程樣板是在指令執行時,透過 Spec Kit 預設集/模板解析堆疊,從 constitution-template 解析而來。
請遵循以下執行流程:
-
從儲存庫根目錄執行
.specify/scripts/bash/resolve-template.sh constitution-template --json,並將TEMPLATE_CONTENT解析為有效模板。- 共享解析器會套用專案覆寫,在核心模板備用方案之前組合預設集層和擴充層。在繼續之前,它必須成功。
- 如果失敗,請停止並報告解析錯誤;不要僅使用一個貢獻模板層繼續。
- 如果
.specify/memory/constitution.md存在,將其載入為當前專案特定值和修訂的來源。在套用新解析的樣板時,保留仍然適用的資訊。 - 如果不存在,則使用解析後的模板作為初始文件。
- 不要寫回任何版本化的模板層。
- 識別所有格式為
[ALL_CAPS_IDENTIFIER]的預留位置令牌。 重要提示:用戶可能需要比模板中使用的更少或更多的原則。如果指定了數字,請遵守該數字 - 遵循一般模板。你將相應地更新文件。
-
收集/推導預留位置的值:
- 如果用戶輸入(對話)提供了值,則使用它。
- 否則,從現有儲存庫上下文(README、文件、先前的章程版本(如果嵌入))推斷。
- 對於治理日期:
RATIFICATION_DATE是原始採用日期(如果未知則詢問或標記 TODO),LAST_AMENDED_DATE如果進行了更改則為今天,否則保留先前日期。 CONSTITUTION_VERSION必須根據語意版本控制規則遞增:- MAJOR:向後不相容的治理/原則移除或重新定義。
- MINOR:新增的原則/區段或大幅擴展的指導。
- PATCH:澄清、措辭、錯字修正、非語意性改進。
- 如果版本提升類型不明確,請在最終確定之前提出推理。
-
使用解析後的模板作為必要結構,草擬更新的章程內容:
- 將每個預留位置替換為具體文字(沒有留下括號令牌,除非是專案選擇尚未定義但故意保留的模板插槽 - 明確說明任何保留的理由)。
- 保留標題層次,註解在替換後可以移除,除非它們仍然提供明確的指導。
- 確保每個原則區段:簡潔的名稱行、段落(或項目符號列表)捕捉不可協商的規則、不明顯的地方提供明確理由。
- 確保治理區段列出修訂程序、版本控制政策和合規審查期望。
-
在更新後的文件頂部,以 HTML 註解的形式產生同步影響報告。 此報告是供人工審查修訂的暫時草稿材料,而非治理內容;預計在修訂後的章程文件提交之前將其移除。
- 版本變更:舊 → 新
- 修改的原則列表(如果重新命名,則為舊標題 → 新標題)
- 新增的區段
- 移除的區段
- 如果故意延遲了任何預留位置,則列出後續待辦事項。
-
最終輸出前的驗證:
- 沒有未說明的殘留括號令牌。
- 版本行與報告相符。
- 日期為 ISO 格式 YYYY-MM-DD。
- 原則是宣告性的、可測試的,且不含模糊語言(「should」→ 在適當時用 MUST/SHOULD 理由取代)。
-
將完成的章程寫回
.specify/memory/constitution.md(覆寫)。 -
向用戶輸出最終摘要,包含:
- 新版本和版本提升理由。
- 任何 TODO 預留位置或需要手動跟進的延遲項目。
- 建議的提交訊息(例如
docs: amend constitution to vX.Y.Z (principle additions + governance update))。 - 針對任何延遲的非治理意圖的「下一步行動」區段。
格式與風格要求:
- 完全按照模板使用 Markdown 標題(不要降低/提升層級)。
- 包裝長理由行以保持可讀性(理想情況下 < 100 字元),但不要強制使用尷尬的斷行。
- 在區段之間保留一個空白行。
- 避免尾隨空白。
如果用戶提供部分更新(例如僅一個原則修訂),仍然執行驗證和版本決策步驟。
如果遺失關鍵資訊(例如批准日期確實未知),插入 TODO(<FIELD_NAME>):explanation 並在同步影響報告中將其包含在延期項目下。
僅寫入 .specify/memory/constitution.md;不要建立或修改模板原始檔。
執行後檢查
檢查擴充鉤子(在章程更新後):
檢查專案根目錄下是否存在 .specify/extensions.yml。
- 如果存在,讀取它並查找
hooks.after_constitution鍵下的條目。 - 如果無法解析 YAML 或格式無效,請不要默默跳過:告知用戶無法讀取
.specify/extensions.yml(包含解析錯誤),並且由於未檢查任何鉤子,包括任何已註冊的必要(optional: false)鉤子,然後繼續正常流程。 - 過濾掉
enabled明確設為false的鉤子。對於沒有enabled欄位的鉤子,預設視為啟用。 - 對於其餘每個鉤子,不要嘗試解釋或評估鉤子的
condition表達式:- 如果鉤子沒有
condition欄位,或該欄位為 null/空,則將該鉤子視為可執行。 - 如果鉤子定義了非空的
condition,則跳過該鉤子,將條件評估留給 HookExecutor 實作。
- 如果鉤子沒有
- 從鉤子命令名稱建構命令調用時,將點號(
.)替換為連字號(-)。例如,speckit.git.commit→/speckit-git-commit。 - 對於每個可執行的鉤子,根據其
optional標誌輸出以下內容:- 可選鉤子(
optional: true):## 擴充鉤子 **可選鉤子**:{extension} 指令:`/{command}` 描述:{description} 提示:{prompt} 要執行:`/{command}` - 必要鉤子(
optional: false):
發出上述區塊後,你必須實際調用鉤子並等待其完成才能繼續。以你在這個代理/會話中執行命令的相同方式執行它(調用方式可能與上面顯示的文字## 擴充鉤子 **自動鉤子**:{extension} 正在執行:`/{command}` EXECUTE_COMMAND:{command}{command}ID 不同,例如,技能模式代理會以/skill:speckit-...或$speckit-...的方式執行)。僅僅發出區塊並不會執行鉤子。
- 可選鉤子(
- 如果沒有註冊任何鉤子,或
.specify/extensions.yml不存在,則默默跳過。