Alphazer01214/coding-skills

coding-skills 是做什麼的？

適用於真實工程的代理技能：對齊、約束、動態計劃、結構驅動的變更、紅循環除錯、程式碼優先的專案對應。

概述

本技能套件包含多個針對真實軟體開發工作流程最佳化的代理技能模組。每個模組皆設計為可獨立或組合使用，以協助 AI 代理（如 Claude Code、Cursor、Codex）更有效地與開發者協作。

技能模組

1. 對齊

確保代理行為與開發者意圖保持一致。透過解析專案規則（如 .cursorrules 或 CLAUDE.md）以及即時反饋，將代理的行動導向預期目標。

2. 約束

為代理行為設定明確的邊界，避免意外修改不相關的檔案或執行未經授權的操作。約束可分為：

• 檔案層級約束：限制代理僅能修改特定目錄或檔案類型。
• 操作層級約束：禁止代理執行特定命令或 API 呼叫。
• 流程層級約束：要求代理在執行關鍵操作前必須先取得人工確認。

3. 動態計劃

建立一個可持續更新的「動態計劃」，在整個對話或專案週期中逐步進化。代理會依據當前進度與反饋自動調整後續任務排序。

4. 結構驅動的變更

要求所有程式碼變更必須通過「結構閘道」檢查。這意味著代理只能在預先定義的架構範本範圍內修改檔案，或必須遵循特定的匯入、導出與類型模式。

5. 紅循環除錯

實作「紅-綠-重構」流程中的紅循環階段。代理會在嘗試修正前先執行測試，確認測試失敗為紅燈，然後才進行修復，確保錯誤再現且修復方案確實有效。

6. 程式碼優先的專案地圖

基於實際程式碼（而非文件）動態生成專案結構地圖。代理會掃描所有原始碼檔案，建立函式、類別與模組的呼叫依賴圖，並將其提供給開發者作為導覽工具。

支援平台

• Claude Code：完全相容，可利用 CLAUDE.md 作為規則來源。
• Cursor：支援透過 .cursorrules 載入技能設定。
• Codex：可透過內嵌提示方式使用部分模組。

使用方法

1. 將此倉庫克隆至您的專案目錄：

   git clone https://github.com/Alphazer01214/coding-skills.git .skills
   

2. 根據您的平台載入技能：

   • 對於 Claude Code：於 CLAUDE.md 中加入引入語句。
   • 對於 Cursor：將 .cursorrules 複製至專案根目錄。

3. 在對話中啟用對應模組：

   • 輸入 /align 啟用對齊模式。
   • 輸入 /constrain 設定約束。
   • 輸入 /plan 初始化動態計劃。

注意事項

• 約束設定應與專案安全需求相符，避免過度寬鬆導致代理行為失控。
• 紅循環除錯模式需要專案中已存在可執行的測試套件。
• 程式碼優先的專案地圖在大型儲存庫中可能耗費較多時間生成。

授權

MIT