Community程式設計與開發github.com

Wanbicoi/agent-config

將當前對話轉化為規格並發布到專案問題跟蹤器:無需訪談,只需綜合你已經討論過的內容。

agent-config 是什麼?

此技能會基於當前對話上下文和程式碼庫理解,直接生成一份詳細的規格文件,而無需再次詢問使用者。它透過在專案問題跟蹤器中創建結構化議題來記錄使用者已經討論過的內容,從而消除重複溝通的浪費。該技能支援任何提供問題跟蹤器存取權限的 AI 代理平台(如 Claude Code、Coder、Codex),但需先通過 `/setup-matt-pocock-skills` 命令提供問題跟蹤器和分類標籤詞彙。運作流程包括:探索程式碼庫以了解現狀、草擬測試 seam(偏好現有 seam 並優先使用最高層級的 seam)並與使用者確認,最後使用預定義模板撰寫規格並發布,並自動套用 `ready-for-agent` 標籤。規格模板涵蓋問題陳述、解決方案、詳盡的使用者故事、實作決策(不含具體檔案路徑或程式碼片段,除非來自原型)、測試決策、範圍外事項及其他備註,確保規格清晰且易於後續的開發工作執行。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Wanbicoi/agent-config/tree/HEAD/skills/to-spec

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

此技能會根據當前對話上下文和程式碼庫理解來產生規格。請勿訪談使用者;只需綜合你已經知道的內容。

問題跟蹤器和分類標籤詞彙應已提供。如果尚未提供,請告訴使用者執行 /setup-matt-pocock-skills。

流程

  1. 探索儲存庫以了解程式碼庫的當前狀態(如果尚未這麼做)。在整個規格中使用專案的領域詞彙表中的術語,並尊重你正在觸及的區域中的任何 ADR。

  2. 草擬你將用來測試該功能的 seam。應優先使用現有 seam。盡可能使用最高層級的 seam。如果需要新的 seam,請在你所能達到的最高點提出建議。程式碼庫中的 seam 越少越好——理想的數量是 1 個。

與使用者確認這些 seam 是否符合他們的期望。

  1. 使用下面的模板撰寫規格,然後將其發布到專案問題跟蹤器。套用 ready-for-agent 分類標籤——無需額外的分類。

問題陳述

使用者面臨的問題,從使用者的角度描述。

解決方案

問題的解決方案,從使用者的角度描述。

使用者故事

一個長長的、編號的使用者故事清單。每個使用者故事應採用以下格式:

  1. 作為一個 <角色>,我想要一個 <功能>,以便 <好處>

這份使用者故事清單應極其詳盡,涵蓋該功能的所有方面。

實作決策

已做出的實作決策清單。這可以包括:

  • 將被建構/修改的模組
  • 將被修改的那些模組的介面
  • 開發人員提供的技術說明
  • 架構決策
  • 結構變更
  • API 合約
  • 具體互動

請勿包含具體的檔案路徑或程式碼片段。它們可能很快就會過時。

例外情況:如果原型產生了一個比散文更能精確表達決策的片段(狀態機、reducer、結構、型別形狀),請在相關決策中內聯它,並簡短註明它來自原型。僅修剪到包含決策的部分,無需提供可運行的演示,只需重要部分。

測試決策

已做出的測試決策清單。包括:

  • 什麼構成一個好的測試的描述(僅測試外部行為,不測試實作細節)
  • 哪些模組將被測試
  • 測試的前例(即程式碼庫中類似類型的測試)

超出範圍

對本規格超出範圍之事項的描述。

進一步備註

關於該功能的任何進一步備註。

Individual skills in this repo

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

相關技能