在您提交issue前，请确认以下信息：

• 我已经搜索过现有和历史issues，确认这是一个新需求

背景信息

背景

MindIE-PyMotor 代码库庞大（coordinator/controller/node_manager/engine_server/metrics + Rust 版 kv-conductor），涉及多种开发规范（测试伴随改动、run_tests.sh 工作流、Python 3.10+ 类型语法、Mulan license 头）与复杂的模块架构。目前 AI 辅助开发缺少项目约定和模块架构的唯一事实来源，导致反复出现违规问题（缺测试、f-string 日志、测试命令用错）、上手慢，且历史 bug 的定位经验无法沉淀复用。

提议

新增 Agent Skill motor-dev，采用 Agent Skills 开放标准（纯 Markdown + YAML frontmatter，Claude Code / Codex / Gemini CLI 等均可读取），放置于通用路径 .agent/skills/motor-dev/。

1. 开发约束（SKILL.md 入口，约 100 行）

• 硬性约束：每个 motor/ 改动必须附带测试、只用 bash tests/run_tests.sh、日志用 %s 占位、Mulan PSL v2 license 头、Python 3.10+ 原生类型语法（X | None 而非 Optional[X]，pre-commit check-modern-typing 强制）
• 模块 → 参考文档路由表：改哪个模块读哪篇，只加载需要的深度
• 渐进式测试工作流：单文件 → 模块 → 全量

2. 深度参考（references/，10 篇，渐进式披露）

统一结构（架构总览 → 关键文件 → 开发规则 → 测试命令），覆盖代码风格、测试指南、Coordinator、Controller、NodeManager、EngineServer、Metrics、E2E 测试、KV Conductor（Rust），以及提 ISSUE 流程。内容与当前 master 源码逐一核对（文件路径、行数、常量、状态机、协议布局均验证一致）。

3. 持续学习（bug-fix-history/）

• 每次调试修复后自动沉淀案例：「为什么会写出这个 bug」的认知教训 + 拦截测试
• 调试前先查轻量索引（INDEX.md），命中关键词再读案例正文——历史增长不增加上下文开销
• 防噪音：仅固化已验证结论、去重、每模块上限 10 例

4. 问题定位后自动提 ISSUE（references/issue-reporting.md）

• 修复闭环完成后询问用户是否按 Motor bug-report 模板提交 ISSUE
• 提 ISSUE 前硬性检查历史 issue（GitCode API 搜索），相似已存在则不重复提交
• 提交方式三选一：GITCODE_TOKEN 直接提交（token 仅环境变量，绝不落盘）/ 生成 markdown 草稿手动粘贴 / 跳过
• 渐进式披露：提 ISSUE 细节仅在用户同意后才加载

为什么重要

1. 一致性：AI 辅助开发自动遵循项目约定（测试、日志、类型、license），评审不再纠结风格问题。
2. 上手成本低：新贡献者（人或 AI）在一个地方了解模块架构，无需通读上万行源码。
3. 上下文高效：渐进式披露让热路径约 100 行，深度知识按需加载。
4. 正确性：固化非显性知识（ZMQ/SHM 协议、状态机转换、KV 事件格式、负数 workload 等踩坑案例），并随开发持续增长。
5. 社区反馈闭环：验证过的问题按模板一键反馈（防重复），反哺上游。

验收标准

• 在 Claude Code 中可通过 /motor-dev 发现该技能（项目级：.claude/skills symlink 指向 .agent/skills；用户级：~/.agent/skills/）
• 所有 skill 文档通过 markdownlint（MD031/MD032/MD033/MD040/MD058/MD024/MD012）
• references 遵循统一结构：架构 → 关键文件 → 开发规则 → 测试命令
• SKILL.md 保持在约 120 行以内（维持渐进式披露）
• bug-fix-history 案例库与 issue-reporting 流程可实际触发（调试闭环 → 案例沉淀 → 提 ISSUE 三选一）
• skill 文档中引用的文件路径/行数与当前 master 源码一致

备注

• 本 skill 当前只包含 motor-dev，后续还会上库更多skill
• .claude/ 已在 .gitignore 中（仅本地 symlink，不进版本库）；其他 Agent 直接读取 .agent/skills/

感谢您的贡献 🎉!