配置工作區
撰寫 /refine-story、/qa-plan、/requirements-discovery 和 /meeting-minutes 所依賴的工作區等級配置。這是一項對話引導的技能,而非自動化腳本:探索、呈現發現、確認,然後才寫入檔案。
步驟
-
探索。 在做出假設之前,先檢查現有檔案:根目錄下的
AGENTS.md和CLAUDE.md、CONTEXT.md、docs/agents/refinement.md和docs/agents/issue-tracker.md(此技能先前的輸出)、.scratch/,以及原始碼存在的跡象:package.json、pyproject.toml、src/、go.mod,或團隊會編譯或執行的任何內容。 如果docs/agents/issue-tracker.md已經存在於另一個慣例中,請保留它:僅驗證它是否指定了發佈位置。如果CLAUDE.md只是一個橋接檔案,內容為@AGENTS.md,則主要指令檔是AGENTS.md。 完成條件:你知道工作區是否已經配置、可能的模式、可能的語言(en-US或pt-BR)、是否存在詞彙表、追蹤器是否存在,以及要編輯哪個指令檔。 -
詢問,一次一個區塊,並以推薦的答案引導。
模式。 根據發現結果推薦:如果存在程式碼,則為
com-codigo(含程式碼);如果不存在,則為sem-codigo(不含程式碼)。用一句話解釋:含程式碼時,代理會在提問前檢查原始碼;不含程式碼時,產品負責人是事實來源,架構問題會變成給團隊的問卷。語言。 根據現有檔案推薦,或預設為
en-US:en-US或pt-BR。用一句話解釋:定義審查、提問回合、敘述、Gherkin 準則和裁決的語言。工作項目。 使用者故事是否來自外部追蹤器?如果是,基本 URL 和欄位慣例是什麼(例如 Azure DevOps 工作項目的
Azure: <ID>)。每個使用者故事都源自那裡,並且每個工件都會攜帶此 ID 行。產品詞彙表。
CONTEXT.md是否已存在?如果沒有,現在不需要任何動作:第一個解決領域術語的審查將會建立它。清楚說明這一點。完成條件:模式、語言、工作項目慣例和基本 URL 均已確認。
-
確認並寫入。 根據 refinement.md 呈現
docs/agents/refinement.md的草稿,根據 issue-tracker.md 呈現docs/agents/issue-tracker.md的草稿(僅當它不存在時),以及代理指令檔的## Refinement區塊。允許調整。然後寫入這些檔案。對於指令檔:如果CLAUDE.md存在並匯入了AGENTS.md(@AGENTS.md),則編輯AGENTS.md;否則,如果存在則編輯CLAUDE.md;否則,如果存在則編輯AGENTS.md;如果兩者都不存在,請詢問要建立哪個。如果## Refinement區塊已存在,則就地更新,不修改檔案的其他部分。
該區塊:
## Refinement
Socratic 精煉工作流程:執行 `/which-flow` 以選擇工作流程。模式和慣例位於 `docs/agents/refinement.md`;追蹤器慣例位於 `docs/agents/issue-tracker.md`。工件位於 `.scratch/<slug>/`,並包含 `狀態:` 和工作項目 ID。
完成條件:refinement.md、追蹤器檔案(新的或保留的)以及指令區塊都已存在且內容已確認。
- 總結。 確認工作區已配置,列出讀取
docs/agents/refinement.md的工作流程,並說明之後可以手動編輯檔案;僅在需要切換模式、語言或追蹤器慣例時,才需要重新執行此技能。