Communitygithub.com

SUGE2016/diaps-chataps

开发或调试 ChatAPS(位于 chataps/ 下的 APS 应用):DiAgent 桥接、MCP 工具、CP-SAT 求解器、看板 UI、运行持久化。在编辑 chataps/、docs/csv、diagent_runtime 或 APS 排程行为时使用。

diaps-chataps 是什么?

这是一个针对 ChatAPS 项目的开发与调试技能,适用于 Cursor 或类似 AI 编码助手。ChatAPS 是一个基于 FastAPI 的高级排程与计划系统 (APS),它集成了 DiAgent 运行时桥接、MCP 工具层、CP-SAT 求解器以及一个看板用户界面。该技能旨在帮助开发者快速理解项目的核心结构、合约关系和调试流程。它提供了关键文件路径的速查表(包括 server.py、mcp_aps.py、solver/ 等)、联调检查清单(如启动命令和日志验证),以及改动原则(最小化修改、新增工具时同步更新多个模块)。支持的平台包括 Cursor、Claude Code 等 AI 编码工具,通过读取项目文档和代码结构来指导用户高效地进行功能开发、问题定位或排程行为优化。使用前需要先阅读 `docs/AGENT_CONTRACT.md` 和 `chataps/diagent_runtime/README.md` 了解边界与工具契约。

兼容平台✓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、契约表。
  • 不把密钥写入文档示例的真实值。

相关技能