Communitygithub.com

AnthonyPoschen/agent-skills

作為軟體開發工作的入口技能。保持此文件的上下文,然後載入任務所需的最小相關參考集。

agent-skills 是什麼?

此技能作為 AI 代理(如 Claude Code、Cursor 或 Codex)進行軟體開發工作的集中入口點。它定義了一個路由系統,根據任務類型(例如,編寫新程式碼、重構、程式碼審查、除錯或架構設計)將代理引導至專門的參考文件(如 `implementation.md` 或 `refactoring.md`)。該技能強調在載入參考資料時要有選擇性,以最大程度地減少混亂並最大限度地提高相關性,從而實現高效的任務執行。它還建立了基本的基準規則,優先考慮正確性、安全性和專案特定約定(格式化工具、linter、測試架構)而非個人風格偏好。當專案模式不明確時,可以參考 `standards.md` 等參考資料。此技能設計為與任何支援或模擬技能文件的 AI 代理平台相容,為軟體開發任務提供結構化、高效的方法。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add AnthonyPoschen/agent-skills

在你喜歡的 AI 中提問

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

說明文件

程式設計

將此技能作為軟體工作的入口點。保持此文件的上下文,然後載入任務所需的最小相關參考集。

路由

  • 如需編寫新程式碼或擴展行為,請閱讀 ./references/implementation.md。
  • 如需重構、清理、簡化、提取、重組或重寫工作,請閱讀 ./references/refactoring.md。
  • 如需程式碼審查、PR 審查、差異評論或風險評估,請閱讀 ./references/review.md。
  • 如需除錯、測試失敗、回歸、執行時期錯誤、CI 失敗或錯誤修復,請閱讀 ./references/debugging.md。
  • 如需架構、API 設計、模組邊界、依賴方向或純設計討論,請閱讀 ./references/design.md。
  • 如需共享程式碼品質規則,請在撰寫或修改程式碼時閱讀 ./references/standards.md,並在審查/設計期間按需閱讀。
  • 如需斷言策略(不變量檢查、除錯與生產斷言決策以及快速失敗契約),請在撰寫或審查驗證內部假設的程式碼時閱讀 ./references/assertions.md。

僅載入使用者當前請求所需的參考資料。如果任務有多個階段,請在該階段開始時載入下一個參考資料。

基準規則

  • 正確性、安全性和使用者意圖優先於風格偏好。
  • 專案格式化工具、linter、測試、建置系統、框架慣例以及系統性的本地模式優先於此技能的預設標準。
  • 當一個本地模式在多個相鄰檔案中出現、由工具強制執行、或是某個明確的框架/應用慣例的一部分時,它即為系統性模式。請勿僅僅因為相鄰而複製一次性的弱程式碼。
  • 當不存在系統性的專案模式時,請使用 ./references/standards.md。
  • 保留公開行為、API、資料合約、遷移和操作語義,除非使用者明確要求更改。
  • 保持修改範圍限定在任務內。改善所觸及的程式碼,使其達到足夠連貫的結果,但不要規範化無關的舊版程式碼。

範例查詢

僅在規則決策不明確時使用範例。

  • ./examples/README.md 索引了重點範例。
  • 一次開啟一個匹配的範例檔案。

相關技能