← 返回作品列表

Project

Redmine Skills

Claude Code Agent Skill,讓 AI 透過自然語言操作 Redmine REST API——工時登打、議題管理、專案建置。

Python Claude Agent Skill Redmine REST API
Redmine Skills

問題

Redmine 操作繁瑣——工時登打要找議題、選活動類型、填時數;議題管理要在網頁間來回切換。即使用 CLI 工具,仍需記指令格式和參數。

方案

設計一個 Claude Code Agent Skill,讓 AI 理解自然語言並直接操作 Redmine API:

  • 意圖路由:AI 根據使用者意圖按需載入對應 API reference,不浪費 context
  • 安全分級:GET 直接執行、低風險 PUT 摘要後執行、工時與 DELETE 需使用者確認
  • 零接觸憑證:API Key 透過 CLI wrapper 內部處理,永不出現在對話中
  • 批次驗證:批次寫入後自動查詢確認結果正確
  • 跨 process 限流:連續請求間隔至少 0.5 秒,防止觸發伺服器速率限制

成果

  • 把高摩擦的 Redmine REST API 操作重新包成自然語言工作流,展示我在內部工具、workflow automation 與企業整合上的產品化能力
  • 不把 AI 當成直接執行的黑盒,而是加入風險分級、確認流程與批次驗證,把可靠性與治理一起納入設計
  • 用 reference routing 控制 context 成本,再以 wrapper 隔離憑證與請求細節,讓 Skill 在可維護的前提下持續擴充 API surface
  • 這個專案重點不只是「可以呼叫 Redmine」,而是把 AI tooling、安全邊界與系統整合做成一個可長期維護的工作流介面