Communitygithub.com

SUGE2016/diaps-chataps

開發或除錯 ChatAPS(位於 chataps/ 下的 APS 應用程式):DiAgent 橋接、MCP 工具、CP-SAT 求解器、看板 UI、執行記錄持久化。適用於編輯 chataps/、docs/csv、diagent_runtime 或 APS 排程行為時使用。

diaps-chataps 是什麼?

ChatAPS 開發 Skill 是專為 AI 代理(如 Cursor 或 Claude Code)設計的專用技能,用於協助開發與除錯 ChatAPS 應用程式——一個整合了 DiAgent 橋接、MCP 工具、CP-SAT 求解器以及看板 UI 的進階排程系統。此技能明確規定了開發邊界與工具契約,並提供關鍵文件引用,例如 `docs/AGENT_CONTRACT.md`(邊界與工具契約)與 `chataps/diagent_runtime/README.md`(如何指向 DiAgent)。它還涵蓋了 DiAgent 運行時代理技能的配置(位於 `chataps/diagent_runtime/skills/chataps-aps/SKILL.md`)。主要支援平台包括 Cursor 與 DiAgent,開發者可利用此技能修改 `server.py`、`mcp_aps.py`、`tools.py` 等核心元件,或調整 `heat_cpsat` 與 `schedule_cpsat` 求解器。該技能強調最小化改動原則,新增工具時須同步更新 `tools.py`、`mcp_aps.py`、運行時 SKILL.md 及契約表,並提供聯調檢查清單以確保 DiAgent 與 MCP 工具正常運作,包含急單排程資源約束檢查與對話恢復驗證。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/SUGE2016/diaps-chataps/tree/HEAD/.cursor/skills/chataps-dev

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

ChatAPS 開發 Skill

必讀

  1. docs/AGENT_CONTRACT.md — 邊界與工具契約
  2. chataps/diagent_runtime/README.md — 如何指向 DiAgent
  3. chataps/diagent_runtime/skills/chataps-aps/SKILL.md — 運行時 Agent Skill(給 DiAgent,不是給 Cursor)

目錄速查

路徑用途
chataps/server.pyFastAPI UI + /api/* + 掛載 MCP
chataps/mcp_aps.pyMCP 工具匯出
chataps/tools.pySTATE + 業務工具
chataps/solver/heat_cpsat / schedule_cpsat
chataps/diagent_bridge.pySSE ↔ DiAgent
chataps/aps_context.py看板快照注入 system
chataps/runs_store.pyrun / chat 落盤
chataps/static/看板 + 排產智能體 UI
docs/csv/試驗主數據
docs/demo-video/產品演示影片物料;生成流程見個人 Skill product-demo-video

聯調檢查清單

  1. ChatAPS python server.py → :8010
  2. DiAgent env 指向 diagent_runtime,:8100
  3. DiAgent 日誌應顯示 MCP 工具數(含 ui_navigate)
  4. 急單後鋸床同資源應 gap≈0(資源約束排程,非全局串行)
  5. 刷新後對話與看板可恢復

改動原則

  • 最小化;先方案後改碼。
  • 新工具:同時改 tools.py、mcp_aps.py、runtime SKILL.md、契約表。
  • 不把金鑰寫入文件範例的真實值。

相關技能