Skip to content

Clean Code AI Collaboration Skill v0.5.0

Choose a tag to compare

View all tags
@eric861129 eric861129 released this 04 Sep 10:58
· 22 commits to main since this release
v0.5.0
bd89577

v0.5.0 重點

這個版本把單一 Core Skill 升級成可依 Changed Module 組合技術 Profile 的架構。Core 仍是授權、風險路徑、驗證與輸出契約的唯一來源；Profile 只補充語言與 Framework 的技術語意。

Composable Profiles

  • 新增 C#、Python、TypeScript 與 React 四個 Experimental Profile。
  • TypeScript 與 React 可依 Changed Module 同時套用，並依 Language、Framework 順序載入。
  • Go、Rust、Java 與 Vue 以 Planned 狀態保留，不會被 Routing 或 Packaging 誤用。
  • 支援 Explicit Profile 與 Core Only；Explicit Profile 仍須通過 Availability、Applicability 與 Conflict 檢查。

Registry、Routing 與文件

  • 新增 Profile Metadata、Catalog 與 JSON Schema Draft 2020-12 契約。
  • 新增 deterministic Changed Module Routing、Reason Code 與 Polyglot Fixtures。
  • Runtime 使用 Generated Profile Index，不要求 Consumer Agent 解析 YAML。
  • 新增 Profile Authoring Guide、生命週期、Evidence 與 Reviewer Checklist。

Specialist Packaging

  • 新增可重現、Fail-closed 的 Specialist Packager 與獨立 Package Manifest Schema。
  • Release mode 全程從 Git Blob 讀取輸入，避免 Dirty Checkout 與 EOL 影響產物。
  • Output Directory 已存在、Path Escape、Symlink Escape、Profile Conflict 等情況都會停止，不覆寫既有內容。
  • 本次沒有附加 Specialist ZIP；dist/clean-code-ai-csharp/ 仍是 Git ignored 的本機 Sample。

驗證

  • 175 項 Repository Tests 通過。
  • Ubuntu 與 Windows GitHub Actions 都通過 Full Tests、Compile、Profile Validator、Generated Drift Check、Release-mode C# Sample Build，以及 Core／Sample Open Standard Validation。
  • v0.4.0 的已發布 Benchmark Evidence 保持不變，歷史重播改從已發布 Tag 的 Git Blob 驗證。

成熟度限制

四個新 Profile 目前都是 Experimental，只代表文件、Metadata、Routing 與 Contract Tests 已完成。尚未執行 M2 Pilot，不宣稱 Beta／Stable，也不宣稱跨 Repository 的普遍品質提升。

安裝

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

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

Assets 2
Loading