Communitygithub.com

leonhoffmann86/團隊衝刺

🏃 衝刺 — 每一個待辦事項都經歷完整的迷你衝刺:自主規劃→實作→審查,適用於 Claude Code,透過 git-hook 代理鏈、隔離工作樹、確定性門檻與失敗封閉審查。

團隊衝刺 是什麼?

這個技能將一個粗略的想法逐步轉化為 TODO.md 中結構化、可操作的項目,遵循嚴格的「任務提煉」工作流程。它首先讀取專案的憲法檔案(如 AGENTS.md 或 CLAUDE.md),以了解風險等級和自主代理規則。接著,技能透過程式碼圖形工具或 Grep/Glob 進行實際的程式碼探查,確定想法所觸及的符號和檔案,以確保建議植基於真實的程式碼庫。在「詰問」階段,它會挑戰這個想法以釐清範圍、風險等級和使用者需要做出的決策,並使用 AskUserQuestion 來收集必要的輸入。最後,它會撰寫一個包含清晰任務、風險等級、完成標準和檔案提示的草稿項目,並將其插入 TODO.md,然後提供啟動自動化實作鏈的選項。此技能支援 Claude Code,並設計用於使用 git-hook 代理鏈和隔離工作樹的專案,確保安全的、確定性的工作流程。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add leonhoffmann86/team-sprint

在你喜歡的 AI 中提問

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

說明文件

你正在將一個粗略的想法轉化成 TODO.md 中一個結構完善的任務。這個粗略的想法是:

$ARGUMENTS

這是一個提煉工作流程,不是實作。不要撰寫程式碼。 在任務清晰且使用者核准之前,不要寫入 TODO.md。請遵循以下步驟進行:

1. 閱讀憲法檔案

找到專案的憲法檔案並閱讀 — 遵守其中的慣例,特別是風險等級以及任何自主代理/待辦事項生命週期規則。

  • 如果存在 sprint.conf,請按順序讀取 SPRINT_CONSTITUTION_FILES 中列出的檔案。
  • 否則,讀取現有的 AGENTS.md 或 CLAUDE.md(以及它們引用的任何專案特定指南,例如前端的 CLAUDE.md)。
  • 如果 .githooks/README.md 存在,請略讀,以便正確描述下游影響。

如果這些檔案都不存在,請告訴使用者此存放庫尚未啟動,並提供 /sprint:bootstrap。

2. 將想法植基於真實的程式碼中(不要猜測)

找出想法所觸及的實際符號/檔案及其影響範圍:

  • 程式碼圖形(優先,如果可用):mcp__codegraph__* 工具(codegraph_search、…_callers、…_callees、…_impact、…_context),或 CLI(codegraph context "<the idea>"、codegraph callers <symbol>、codegraph impact <symbol>);如果索引看起來過時,請先執行 codegraph sync .。
  • 備援方案(無程式碼圖形):使用 Grep/Glob 找到相關符號及其呼叫者。

閱讀實際相關的幾個檔案。指出具體的函式/檔案以及變更的著陸點。

3. 詰問它(此技能的核心)

根據程式碼已經做的事情挑戰這個想法。指出:

  • 這是一個問題還是一個任務?如果它實際上是一個問題(「……還是我遺漏了什麼?」),請先從程式碼中回答 — 現有邏輯可能已經涵蓋了部分內容。
  • 真正的範圍以及能帶來價值的最小變更。
  • 風險等級(根據憲法檔案 / AGENTS.md)。如果是高風險,請說明 — 它將不會被自動實作;鏈會將其延遲給人類處理。
  • 那些需要由使用者做出的決策,而不是你(產品/使用者體驗/政策選擇)。使用 AskUserQuestion 向使用者詢問那些少數決策。不要為真正的產品決策編造答案;使用程式碼庫中的證據糾正錯誤的假設。

4. 草擬一個結構化的項目(四個要素)

撰寫一個草稿,包含:

  1. 一個清晰的命令式任務(不是問題),
  2. 風險等級,
  3. 一個具體的完成標準(哪個目標測試必須通過 / 哪個行為是可驗證的),
  4. 來自步驟 2 的檔案/函式提示。

讓它保持最小的有價值變更。展示草稿並進行調整,直到使用者滿意為止。

5. 寫入 TODO.md,然後交接

  • 將核准的項目作為 - [ ] 條目新增到 TODO.md 的頂部附近。
  • 詢問是否要將它設為唯一的活躍項目 — 如果是,請將其他目前活躍的項目移動到 <!-- … --> 區塊(或根據跳過慣例放在 ## 🚧 Deferred 下方),以便鏈只選取這個項目。
  • 不要自動提交。 告訴使用者:提交 TODO.md 會啟動規劃→實作→審查鏈(實作會落地到實作分支,沒有自動合併)。提供選項讓他們在想要現在開始流程時提交。

保持對話簡潔:先紮根實際情況,只詢問真正重要的決策,然後再撰寫。

相關技能