Communitygithub.com

ALVIN-YANG/ay-skills

經人工核准的小型工作流程,專為 AI 編碼代理而設計。

ay-skills 是什麼?

ALVIN-YANG/ay-skills 是一個專為 AI 編碼代理(如 Claude Code、Cursor、Codex 等)設計的技能集,旨在透過小型、經人工核准的工作流程,提升程式碼修復的效率與可靠性。其核心技能「AY Fix」遵循嚴謹的合約:先診斷原因、再決定修復範圍、最後執行修復並驗證,確保每一步都基於明確的事實與使用者授權。支援的指令包括診斷(僅限唯獨操作)、提案(針對不明確的變更提出建議)與自主執行(核准後自動執行)。此技能強調「最小授權修復」,避免代理做出未經核准的假設或變更,並要求在使用外部動作或不可逆操作前獲得明確確認。透過結構化的診斷流程(捕捉症狀、再現、追溯、假設驗證)與嚴格的修復邊界決策,它幫助開發者減少錯誤導入,確保每次修復都經過因果驗證與回歸測試,最終提升程式碼庫的穩定性與可維護性。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add ALVIN-YANG/ay-skills

在你喜歡的 AI 中提問

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

說明文件

AY 修復

證明原因,然後進行最小且經核准的修復,以防止問題再次發生。

核准合約

  • 完整閱讀請求並調查可發現的事實,然後再詢問使用者。
  • 將審查、診斷、說明與規劃視為唯獨操作,除非使用者同時要求變更。
  • 當目標、可觀察的結果與接受邊界明確時,將精確的指令視為核准。
  • 廣泛的結果授權調查,而非基於代理必須自行發明的選擇來變更檔案或成品。
  • 對於實質上規格不足的變更,提出一個建議方案,並等待核准。
  • 核准後,在核准的邊界內自主執行;不要詢問一般的實作細節。
  • 僅在新證據改變行為、架構、資料合約、依賴關係、範圍、風險、成本、回退或外部動作時,才重新開啟核准。
  • 僅在請求或核准的方案中包含外部動作時,才執行它們。在執行不可逆動作之前,確認確切的目標。
  • 保留無關的與使用者撰寫的工作。在聲稱完成之前,驗證實際要求的結果。

診斷

  1. 捕捉確切的症狀、預期的行為、環境與失敗層。
  2. 透過最接近的可行路徑重現,或說明缺少的重現條件。
  3. 從錯誤輸出回溯到最早的不正確狀態。在相關時閱讀最近的變更與工作範例。
  4. 形成競爭假設,並執行最小的區分檢查。在缺少觀察時,對邊界進行儀器化。
  5. 確認原因。似是而非的跡象、相關性或已消失的症狀,並非證明。

在假設失敗後,收集新證據,然後再嘗試另一個假設。不要反覆編輯以取代診斷。

決定修復邊界

如果使用者僅要求診斷,則在此處停止,並提供確定的原因或下一個區分檢查。

如果使用者要求修復,則僅當根因修復是唯一、局部、可逆且保留預期行為時,才繼續進行而不另設檢查點。當替代方案會改變產品行為、架構、資料合約、依賴關係、範圍、外部狀態或重大風險時,請先提出修復方案。

修復與證明

在最狹窄的責任邊界修復原因,而非其下游症狀。當存在穩定的行為接縫時,加入回歸檢查;不要為不可測試的表面發明空洞的測試。

重新執行原始的再現、回歸檢查與相關的相鄰項目。分離環境、測試工具、原始碼、建置、套件、部署與實際執行階段的證據。如果原因仍未證明,請明確說明。

報告原因、區分證據、修復、證明與剩餘不確定性。

相關技能