Community生產力與協作github.com

RafaelFerSilva/refinement-agent-skills

配置工作區以執行精煉工作流程:設定操作模式(含程式碼或不含程式碼)、本地 Markdown 追蹤器、發佈慣例,以及 AGENTS.md 或 CLAUDE.md 中的代理指令區塊。每個工作區執行一次。

refinement-agent-skills 是什麼?

此技能會引導使用者完成配置工作區所需的對話步驟,以支援一系列精煉工作流程,例如 `/refine-story`、`/qa-plan`、`/requirements-discovery` 和 `/meeting-minutes`。它並非自動化腳本,而是探索式技能:先檢查現有檔案(包括 AGENTS.md、CLAUDE.md、CONTEXT.md 及程式碼存在的跡象),再提出建議,並在寫入任何內容之前先取得使用者確認。建議的配置涵蓋操作模式(含程式碼,代理會檢查原始碼;不含程式碼,產品負責人即為事實來源)、語言(en-US 或 pt-BR)、外部工作項目追蹤器慣例,以及產品詞彙表狀態。使用者確認後,技能會寫入或更新最多三個檔案:`docs/agents/refinement.md`、`docs/agents/issue-tracker.md`(若不存在),以及主要代理指令檔案(CLAUDE.md 或 AGENTS.md)中的 `## Refinement` 區塊。此技能可在任何支援 AGENTS.md 或 CLAUDE.md 慣例的平台上使用,例如 Claude Code、Cursor 或 Codex,且專為完成 Socratic 精煉工作流程配置而設計。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/RafaelFerSilva/refinement-agent-skills/tree/HEAD/skills/configure-refinement

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

配置工作區

撰寫 /refine-story、/qa-plan、/requirements-discovery 和 /meeting-minutes 所依賴的工作區等級配置。這是一項對話引導的技能,而非自動化腳本:探索、呈現發現、確認,然後才寫入檔案。

步驟

  1. 探索。 在做出假設之前,先檢查現有檔案:根目錄下的 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)、是否存在詞彙表、追蹤器是否存在,以及要編輯哪個指令檔。

  2. 詢問,一次一個區塊,並以推薦的答案引導。

    模式。 根據發現結果推薦:如果存在程式碼,則為 com-codigo(含程式碼);如果不存在,則為 sem-codigo(不含程式碼)。用一句話解釋:含程式碼時,代理會在提問前檢查原始碼;不含程式碼時,產品負責人是事實來源,架構問題會變成給團隊的問卷。

    語言。 根據現有檔案推薦,或預設為 en-US:en-US 或 pt-BR。用一句話解釋:定義審查、提問回合、敘述、Gherkin 準則和裁決的語言。

    工作項目。 使用者故事是否來自外部追蹤器?如果是,基本 URL 和欄位慣例是什麼(例如 Azure DevOps 工作項目的 Azure: <ID>)。每個使用者故事都源自那裡,並且每個工件都會攜帶此 ID 行。

    產品詞彙表。 CONTEXT.md 是否已存在?如果沒有,現在不需要任何動作:第一個解決領域術語的審查將會建立它。清楚說明這一點。

    完成條件:模式、語言、工作項目慣例和基本 URL 均已確認。

  3. 確認並寫入。 根據 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、追蹤器檔案(新的或保留的)以及指令區塊都已存在且內容已確認。

  1. 總結。 確認工作區已配置,列出讀取 docs/agents/refinement.md 的工作流程,並說明之後可以手動編輯檔案;僅在需要切換模式、語言或追蹤器慣例時,才需要重新執行此技能。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能