描述

主会话通过 ops-direct-invoke Skill 承接算子任务，负责需求对齐、流程编排与交付组织。子 Agent 按客户端角色配置和 harness 派发的 task 执行与验收。

• PM 从用户原始需求开始，首次集中确认 conda/Python、CANN 与修改权限，代答四项启动输入，按整个任务沿用有效授权。
• 每轮根据目标与有效产物准备 YAML；同轮中断恢复使用原 YAML 和运行目录。
• 节点按自身角色与任务使用模板、脚本和知识 Skill，保持职责与权限边界。
• 安装器同步 Skill、角色和配置记录，清理 AGENTS.md / CLAUDE.md 中本插件的完整管理区块，保留用户内容、其他插件区块和无完整标记的自定义内容；重复安装幂等。
• README、QUICKSTART、入口 Skill 和 maintain 资料直接描述当前职责、调用关系与操作方法。

改动范围为 PM 入口、安装器、维护资料与测试。harness core、调度 Skill、三个子 Agent 角色和依赖 gitlink 保持不变；用户正在运行的算子工作区保持不变。

关联的Issue

无。后续重构，基于已合入的 PR #159。

测试

• 按 ops-direct-invoke-maintain 完整运行 test/ut/test_all.py：6 类、61 项通过，本次文案整理后已完整重跑。
• 两份修改后的 Skill 通过 skill-creator quick_validate.py；文档本地链接与 git diff --check 通过。
• script/test/harness.test.js：36 项全部通过。覆盖源码/打包安装、五种客户端配置更新、两种项目指引的管理区块清理、重复安装、用户与其他插件内容保留、不完整标记保护。固定子图 template 字段的测试断言验证：组装输出应剥离该字段且子图文件实际落盘，未改组装器或 harness。
• script/test/install.test.js 中指引重装与多插件共存两项通过，确保仍有 AGENTS.md 的其他插件保留原安装行为。
• 实现阶段已完成临时工作区真实 OpenCode 只读冒烟（本次文案整理未重跑）：主会话实际加载入口并确认 PM 身份与首次环境/权限问题；开发者角色读取执行记录模板后仍为 executor，缺输入时报告阻塞，不进行需求确认或派发。主会话初次加载后的响应超时，在同一会话缩小为身份确认后完成。未运行真实算子/NPU 开发，不将身份冒烟等同于端到端业务验收。
• 全仓 npm test 在 pretest 打包阶段受既有外部依赖缺失阻塞：社区插件 ascendc-port-orchestrator 引用 ops/ascendc-cross-gen-port-light，但公共仓缺少该目录。使用公共仓 master 393564ae43f304426db2c206e361cd43b2811413 亦复现；未顺带改动该插件。上述相关安装测试使用该依赖版本构建 ops-direct-invoke 与 model-infer-optimize 后执行，测试后已恢复原 gitlink。

文档更新

更新 ops-direct-invoke 的 README、QUICKSTART、maintain Skill 及相关维护资料。QUICKSTART 仅提供首次安装、启动、任务示例和结果位置，README 的交叉链接同步。

类型标签

• 🐛 Bug 修复
• 🧪 测试用例
• 📝 文档更新
• ♻️ 代码重构
• 🧹 代码清理