RCF-047 — AK Plugin SKILL 執行機制修正

類型：SKILL 日期：2026-05-18 觸發條件：條件 4 — 修改 8 個 AK Plugin SKILL 的核心執行步驟記錄 相關文件：

CLAUDE.md（SKILL 表 8 條 AK 條目）
knowledge/operations/commands-reference.md（一B、AK 專區）

問題背景

Tim 說「語感分析」後，Claude 依 CLAUDE.md 記載呼叫 Skill({ skill: "plugin:ak-threads-booster:voice" }) → 回傳 "Unknown skill"。

調查過程：

第一假設：:subskill suffix 格式有問題 → 嘗試 plugin:ak-threads-booster（無 suffix）→ 同樣回傳 "Unknown skill"
根本原因確認：讀取 plugin.json（C:\Users\USER\.claude\plugins\cache\ak-threads-booster-marketplace\ak-threads-booster\1.1.0\.claude-plugin\plugin.json）→ 確認 plugin.json 只有 7 個欄位，無 skills 陣列 → Skill 工具沒有索引可查，所有 plugin:ak-threads-booster:XXX 格式一律失敗
歷史執行驗證：AK 初始化 ✅ 曾成功執行 → 查 dev/CLAUDE.md L98：「/setup 596 貼文已完成」→ 這個 /setup 是記錄執行結果的標注，不是 Skill 工具呼叫的語法；實際執行方式是 Claude 手動讀取 plugin SKILL.md 並依步驟執行

核心診斷：CLAUDE.md SKILL 表的「詳細規格」欄記載 AK plugin：\plugin:ak-threads-booster:setup`` 等格式是錯誤記錄——這個格式從未能工作，歷史成功是因為 Claude 手動讀取 SKILL.md 執行，而非 Skill 工具。

考慮過的方案

方案	描述	優點	缺點	採用？
方案 A（維持現狀）	保留錯誤記錄，每次觸發時靠 Claude 自行判斷降級	零修改成本	每次觸發都會先嘗試錯誤路徑浪費 token；記錄與實際不符	❌ 未採用
方案 B（找 Skill 工具正確格式）	研究是否有其他 plugin 呼叫語法	若成功可保留 Skill 工具路徑	plugin.json 無 skills 陣列 = 根本無法工作，無其他格式可嘗試	❌ 未採用（技術不可行）
方案 C — 正確記錄手動執行機制（最終採用）	將 8 條 AK 條目的「詳細規格」改為手動讀取對應 plugin skills/[subskill]/SKILL.md；commands-reference.md 同步修正機制說明	記錄與實際執行一致；下次觸發 Claude 直接走正確路徑	無	✅ 採用

最終決策

採用方案 C。

為什麼不是方案 A：「系統狀態異動硬性記錄規則」明確要求：發現記錄與實際狀態不符，必須修正記錄。保持錯誤記錄違反核心原則。

為什麼不是方案 B：plugin.json 確認無 skills 陣列，Skill 工具無法存取 user-scope plugin，這是工具本身的限制，無替代語法可繞過。

核心設計原則：AK Plugin 的執行機制自始就是「Claude 手動讀取 SKILL.md + 依步驟執行」，與 HQ SKILL（透過 Skill 工具讀取 .claude/skills/）不同。修正後的記錄準確反映這個設計。

影響範圍

影響類型	具體項目
修改文件	`CLAUDE.md` — 8 條 AK SKILL 條目「詳細規格」欄：`AK plugin：\`plugin:ak-threads-booster:XXX``→`手動讀取 plugin skills/[subskill]/SKILL.md（Skill 工具無法存取 user-scope plugin）`
修改文件	`CLAUDE.md` — `語感分析` 狀態 ⏳ → ✅（執行機制已確認，brand_voice.md 已存在）
修改文件	`knowledge/operations/commands-reference.md` — 一B AK 專區：機制說明從「Skill 工具呼叫」改為「手動讀取 plugin SKILL.md」；`語感分析` 測試狀態 ⏳ → ✅；`brand_voice.md` 文件狀態 ⚠️ → ✅
觸發部門同步	無（AK Plugin 為跨部門工具，無對應部門 CLAUDE.md）
影響的 SKILL	全部 8 個 AK Plugin SKILL（setup/voice/draft/topics/analyze/refresh/review/predict）

驗證方式

下次 Tim 說「語感分析」或其他 AK 觸發詞：

Claude 不再呼叫 Skill({ skill: "plugin:ak-threads-booster:..." })
直接讀取 C:\Users\USER\.claude\plugins\cache\ak-threads-booster-marketplace\ak-threads-booster\1.1.0\skills\[subskill]\SKILL.md
依 SKILL.md 步驟執行，無「Unknown skill」錯誤