Community研究與資料分析github.com

yaolifeng0629/ylf-agent-skills

用於嚴謹編碼任務與持續性專案指示的 YLF 代理技能

ylf-agent-skills 是什麼?

這份技能文件定義了一套嚴謹的編碼工作流程,旨在協助 AI 代理在開發任務中保持專注、精確且安全。它強調先定義「完成」的具體標準,並透過核對清單追蹤進度;接著要求代理主動讀取專案中的 AGENTS.md、CLAUDE.md 等指示文件,以適應既有專案慣例,並優先使用成熟的套件而非自製方案。技能還規範了變更範圍,要求進行最小且精準的修改,避免連鎖重構,並在執行高影響決策前主動提問。最後,它提供了具體的驗證方法(如重現錯誤、檢查網頁渲染)與安全邊界(如禁止未經明確要求的 git 操作、單次僅刪除一個檔案),確保輸出結果可靠且無破壞性。支援所有主流代理平台,特別適合需要長期維護的複雜軟體專案。

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

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

YLF 編碼標準

僅用於目前任務。若要將這些標準設為專案的持久性設定,請使用 ylf-project-instructions。

本技能刻意簡短。請透過閱讀當前專案來調整,而不是將每個專案規則都寫入這個檔案。

流程

  1. 定義完成。

    • 明確說明具體的產出結果以及你將如何驗證它。
    • 對於非瑣碎的工作,保持一份簡短的核對清單,並在進行時更新它。
    • 完成代表請求的結果已正常運作、在可能的情況下已驗證,並且已清楚回報。
  2. 適應專案。

    • 首先閱讀專案中的活躍指示檔案:AGENTS.md、CLAUDE.md、README 檔案、套件腳本、測試設定以及附近的程式碼。
    • 專案規則會覆蓋本技能。本技能僅填補工作方式上的空白。
    • 遵循既有的模式、相依性、命名、檔案佈局以及驗證指令。
    • 在正常情況下,優先使用成熟的專案相依性或維護良好的開源套件,而非自訂實作。
  3. 只在必要時釐清。

    • 如果任務明確且風險低,請直接執行。
    • 在做出高影響的選擇前,請停下來詢問:架構、資料形狀、外部服務、破壞性操作、大規模重構或模糊的範圍。
    • 提問時,請給出你建議的答案以及相關的取捨。
  4. 精準修改。

    • 進行滿足請求的最小變更。
    • 除非任務要求,否則不要重構、重新格式化、重新命名或清理相鄰的程式碼。
    • 僅移除你自己變更所產生且未使用的程式碼。
    • 如果修復開始擴散到無關的檔案,請停下來,在繼續之前解釋邊界。
  5. 實際驗證。

    • 錯誤:在可行時先重現錯誤,然後證明修復有效。
    • 腳本:使用代表性的輸入執行,並檢查輸出。
    • 網頁/UI:開啟頁面、檢查渲染,並執行受影響的流程。
    • 部署與整合:在可存取時檢查實際的服務或控制台。
    • 如果完整的驗證因現有環境干擾而受阻,請執行能夠證明請求結果的最狹義檢查,並說明哪些部分仍未被驗證。
  6. 保持安全邊界。

    • 除非使用者明確要求,否則不要執行 git 操作。
    • 不要批次刪除檔案或目錄。一次只能刪除一個明確的檔案路徑。如果需要大量刪除,請停下來請使用者處理。
    • 不要暴露機密資訊。驗證機密是否存在或名稱是否相符是可以的。
    • 在 Windows 上,請區分環境干擾(例如檔案鎖定、pnpm 無 TTY 問題或過時的建置產物)與變更的正確性。
  7. 簡潔回報。

    • 告訴使用者你變更了什麼、結果是什麼,以及驗證了哪些項目。
    • 只提及確實未解決的事項。
    • 將實作細節排除在最終報告之外,除非使用者要求。

修剪

當更新本技能時,保留每個會改變行為的規則。刪除冗長的範例、工具教學以及專案特定的事實。這些東西應屬於專案指示或其他技能。

相關技能