Skip to content

Clean Code AI Collaboration Skill v0.4.0

Choose a tag to compare

View all tags
@eric861129 eric861129 released this 04 Sep 04:49
· 39 commits to main since this release
v0.4.0
d0b5282

v0.4.0 重點

這個版本讓使用者可以明確選擇 AI Agent 的開發節奏與驗證範圍，同時保留 Clean Code、Repository 規則、必要 Gate 與授權邊界。

新增開發節奏

  • auto：依風險、測試 Oracle、回饋速度、工作樹與授權判斷。
  • direct：適合小型、可逆且行為已知的修改。
  • tdd：先以 RED 說清楚需求缺口，再完成最小 GREEN。
  • tcr：只在測試快速可靠、工作樹隔離且具備當次 Commit／Revert 授權時使用。
  • characterization-first：先固定 Legacy Code 的現有可觀察行為。

新增驗證範圍

  • auto
  • focused
  • repository
  • acceptance-e2e
  • mutation-assisted

開發節奏與驗證方式彼此獨立，例如可以使用 TDD 開發，再加入 E2E 驗證跨邊界結果。

安全與操作邊界

  • 明確策略缺少前提時，Agent 必須停止並回報，不能偷偷改用其他節奏。
  • development_rhythm: tcr 不等於授權 Commit 或 Revert。
  • 使用者選擇的驗證範圍不能取消 Repository 既有的必要 Gate。
  • Codex adapter 維持 explicit-only，請明確指定 $clean-code-ai-collaboration。

README 與評測

README 新增快速開始、Prompt／AGENTS.md 設定方式、巢狀規則、TDD／TCR 範例、常見組合、FAQ，以及 Windows、macOS、Linux 的安裝與重播指令。

固定策略案例的無 Skill 對照為 5／9 符合決策契約；載入 v0.4.0 後，18 次執行為 18／18 通過。這項結果只支持固定情境下的策略契約解讀較一致，不衡量程式碼品質，也不宣稱一定節省 Token、時間或費用。

評測樹雜湊採用固定的 POSIX 相對路徑排序，已在 Windows 本機與 GitHub Actions Linux Runner 驗證可重播。

安裝

git clone https://github.com/eric861129/Clean-Code-AI-Collaboration-Skill.git
cd Clean-Code-AI-Collaboration-Skill
git checkout v0.4.0

真正需要安裝的是 clean-code-ai-collaboration 資料夾。完整安裝方式與設定範例請閱讀 README。

Assets 2
Loading