@cannbot-plugin/cannbot-harness 0.0.0-stage → 0.1.5

package/README.md

@@ -1,3 +1,105 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# CANNBot Harness
+
+CANNBot Harness 是安装在原版 DeepSeek Harness（DSH）中的独立插件。
+Windows 桌面端和 Linux Web 端使用同一个 `.tgz` 安装包。
+
+## 使用
+
+- 在 DSH 的插件页面启用 **CANNBot Harness**：立即显示品牌、红白主题和工作流选择，同时挂载 40 个 Skills。
+- 左下角没有额外开关；界面跟随插件本身的启用状态，早期版本保存的界面关闭偏好不再影响显示。
+- 选择工作目录，在 **选择工作流 → 算子开发工作流** 中点击一次，输入框会填入 `/ops-direct-invoke `。
+  继续输入需求，然后手动发送。已有正文、引用和附件不会被替换；重复选择不重复添加命令。
+- 在 DSH 的插件页面停用 **CANNBot Harness**：恢复原版界面和模式选择，同时卸载 Skills；重新启用后界面与 Skills 一起恢复。
+- 本插件不提供 SSH 或远程连接控件。Linux 用户通过 DSH 自身的 Web 界面访问服务。
+
+## 安装
+
+当前验证目标：**DSH 0.2.1-rc.3**，Node.js 24.9 或更新版本。
+安装包包含 40 个 Skills、角色、模板、脚本、许可证和来源记录，不含 DSH 可执行文件。
+本地安装不会从 npm 下载私有的 CANNBot 子包。
+
+### 按 npm 包名安装
+
+分发包名为 `@cannbot-plugin/cannbot-harness`，界面名称仍为 **CANNBot Harness**。
+Windows 桌面端先正常退出 DSH，再用 DSH 自带的 CLI 安装：
+
+```powershell
+dsh plugin --profile desktop add @cannbot-plugin/cannbot-harness@0.1.5
+```
+
+Linux 使用运行 DSH 的同一用户安装，随后启动对应配置：
+
+```bash
+dsh plugin --profile web add @cannbot-plugin/cannbot-harness@0.1.5
+dsh web --no-open
+```
+
+使用自定义 profile 时，将 `web` 换成实际的配置名。安装完成后重新打开 DSH。
+如果已安装早期本地预览包 `@cannbot/dsh-harness`，先在同一个 profile 中移除旧包，
+避免两份插件同时挂载界面和 Skills：
+
+```bash
+dsh plugin --profile <你的配置名> remove @cannbot/dsh-harness
+```
+
+### Windows 桌面端
+
+在原版 DSH 的 **插件 → 添加插件** 中安装本地文件 `cannbot-plugin-cannbot-harness-0.1.5.tgz`。
+安装后启用 **CANNBot Harness**。如果当前 DSH 提示需要重启，正常退出并重新打开 DSH。
+也可先完全退出 DSH，再用 DSH 自带的 CLI：
+
+```powershell
+dsh plugin --profile desktop add "C:\Downloads\cannbot-plugin-cannbot-harness-0.1.5.tgz"
+```
+
+### Linux 浏览器端
+
+先安装原版 DSH，再将安装包放到服务器上，以运行 DSH 的同一用户执行：
+
+```bash
+dsh plugin --profile web add /path/to/cannbot-plugin-cannbot-harness-0.1.5.tgz
+dsh web --no-open
+```
+
+使用 DSH 输出的带认证信息的完整地址打开浏览器。使用自定义 profile 时，两条命令应选择同一个 profile。
+DSH 的浏览器访问、认证、绑定地址及模型配置仍按原版方式管理。
+插件及 Skills 随 DSH 安装在 Linux 上，实际工具执行也发生在 Linux 上。
+
+## 实现
+
+`dsh.bundle` 声明标准 Bundle，`cordis.patch.yml` 仅插入本插件的一行。
+Node 半区通过官方 `FileSystemSkillProvider` 挂载随包 Skills。
+Browser 半区使用原有品牌插槽、`conversation.hero.agentPreset` 和主题覆盖 API。
+插件启用时直接挂载界面；停用时撤销插槽和主题覆盖，原版控件一直保留在下层，不改写 DSH 核心文件。
+工作流图标直接复用 DSH 标准模式使用的 `IconAgentPresetOutlineRegular`。
+工作流选择调用 DSH 的 `inputActions.insertText`，在当前草稿第一个位置插入命令，并保留引用和附件；不自动提交。
+
+首页标题的样式规则仅以本插件的品牌插槽标记为锚点，隐藏旁边的原版标语；不依赖 DSH 私有 CSS 类名。
+该规则与插件的界面生命周期一起撤销。DSH 的插件 API 仍在预览阶段，升级 DSH 后需要重新验证。
+
+Skills 为上游 ops-direct-invoke 3.0.0 的原始资源，来源为 `@cannbot-plugin/cannbot` 1.9.1。
+DSH 能读取这些 Skills。部分完整工作流仍依赖上游 `cannbot` 执行器、Python、CANN/Ascend 以及对应项目环境；
+安装 Skills 不会自动安装上述执行环境。
+
+## 开源构建
+
+源码与 DSH 源码分开。开发时需要同版本的官方 DSH 源码，先在该仓库按官方说明完成 `pnpm install` 和 `pnpm run build`。
+当前验证的源码提交为 `22ddee3792402c3e70ec5f86a63c3e3e895a2f60`。
+默认相邻目录为 `../deepseek-harness`，也可在准备开发环境时传入目录或设置 `DSH_SOURCE`。
+构建复用官方 `packages/client/tsdown.client.ts`；不会重新编译 DSH 桌面程序或替换服务端代码。
+
+```bash
+node scripts/prepare-dev.mjs /path/to/deepseek-harness
+node node_modules/typescript/bin/tsc --noEmit
+node scripts/build.mjs
+node --test tests/host.test.mjs
+node scripts/package.mjs
+```
+
+开发链接仅生成在本项目 `node_modules` 中，安装包不包含这些链接或开发仓库路径。
+npm 分发包名为 `@cannbot-plugin/cannbot-harness`。同版本的 npm 包和本地 `.tgz` 包包含相同的构建产物与 Skills。
+
+## License
+
+上游资源保留 CANN Open Software License Agreement 2.0。
+详见 `THIRD_PARTY_NOTICES.md`、`upstream.json` 和 `assets/ops-direct-invoke/LICENSE`。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,11 @@
+# Third-party notices
+
+CANNBot Harness includes the unchanged ops-direct-invoke 3.0.0 resources from
+`@cannbot-plugin/cannbot` 1.9.1. Its original license is included at
+`assets/ops-direct-invoke/LICENSE`. The original files and attribution are retained.
+The source archive identity and checksums are recorded in `upstream.json`.
+
+The palette and decorative C mark were developed for this plugin. DSH, Cordis,
+Schemastery and DSH's UI libraries remain separately installed dependencies with
+their original licenses. The build uses the official DSH client bundle preset;
+this package contains no redistributed DSH desktop executable or server runtime.

package/assets/ops-direct-invoke/.cannbot-bundle

@@ -0,0 +1 @@
+Skills are copies in this npm snapshot.

package/assets/ops-direct-invoke/.claude-plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "ops-direct-invoke",
+  "version": "3.0.0",
+  "description": "直调算子开发工作流，负责 Ascend C <<<>>> 方式直调算子的开发。",
+  "author": {
+    "name": "CANNBot"
+  },
+  "homepage": "https://gitcode.com/cann/cannbot",
+  "repository": "https://gitcode.com/cann/cannbot",
+  "license": "CANN-2.0",
+  "keywords": [
+    "ascendc",
+    "workflow",
+    "harness"
+  ],
+  "agents": [
+    "./agents/ops-direct-invoke-architect.md",
+    "./agents/ops-direct-invoke-developer.md",
+    "./agents/ops-direct-invoke-verifier.md"
+  ]
+}

package/assets/ops-direct-invoke/.codex-plugin/plugin.json

@@ -0,0 +1,30 @@
+{
+  "name": "ops-direct-invoke",
+  "version": "3.0.0",
+  "description": "直调算子开发工作流，负责 Ascend C <<<>>> 方式直调算子的开发。",
+  "author": {
+    "name": "CANNBot"
+  },
+  "homepage": "https://gitcode.com/cann/cannbot",
+  "repository": "https://gitcode.com/cann/cannbot",
+  "license": "CANN-2.0",
+  "keywords": [
+    "ascendc",
+    "workflow",
+    "harness"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "直调算子开发工作流",
+    "shortDescription": "Ascend C <<<>>> 方式直调算子开发工作流",
+    "longDescription": "直调算子开发工作流，负责 Ascend C <<<>>> 方式直调算子的开发。",
+    "developerName": "CANNBot",
+    "category": "Productivity",
+    "capabilities": [
+      "Skills"
+    ],
+    "defaultPrompt": [
+      "开发一个 abs 算子。"
+    ]
+  }
+}

package/assets/ops-direct-invoke/AGENTS.md

@@ -0,0 +1,93 @@
+# 算子开发团队 PM
+
+## 身份与职责
+
+你是算子开发 Agent 团队的 PM (Project Manager)，负责与用户对接、对齐需求、规划任务并组织交付。保持上下文精简；除需求分析与流程管理外，具体方案设计、代码编写、测试执行等工作必须交给子 Agent。
+
+- 识别到算子开发任务时，立即加载 `ops-direct-invoke` Skill，按其中的要求执行。
+- 调度子 Agent 前，必须加载 `workflow-orchestrator` Skill，按其中的指引组织 Workflow YAML，通过 harness core 的公开接口下发任务；禁止通过其他方式直接拉起子 Agent。
+
+## 可调度角色
+
+| Agent | 职责 | 典型交付件 |
+|---|---|---|
+| `ops-direct-invoke-architect` | 负责所有规划、探索类工作 | 设计文档或探索报告 |
+| `ops-direct-invoke-developer` | 负责代码开发、功能验证等需要具体执行的工作 | 具体代码或执行结果 |
+| `ops-direct-invoke-verifier` | 负责所有验收类工作 | 通过或不通过的结论，可附被验收内容的修改意见 |
+
+角色负责身份与权限，Skill 提供工作方法，task 声明输入、输出及验收要求。PM 不进入任务图；只使用客户端实际支持的角色与权限。
+
+## 工作目录
+
+每个用户任务在工作区 `.cannbot/` 下创建独立任务目录，每个 Workflow 再创建一个独立子目录：
+
+```text
+.cannbot/
+└── 任务1/
+    ├── workflow1/
+    │   ├── workflow1.yaml
+    │   ├── 需求与输入记录
+    │   ├── 交付件与验收报告
+    │   ├── orchestrator.log
+    │   └── .workflow/          # harness 管理的运行状态与会话记录
+    └── workflow2/
+        ├── workflow2.yaml
+        ├── 需求与输入记录
+        ├── 交付件与验收报告
+        └── .workflow/
+```
+
+- 当你开始工作时，先检查 `.cannbot/` 目录是否存在，如果不存在，立即创建它。
+- 任务目录名应反映用户目标。如果涉及算子开发，需要以算子名命名。如果已有对应算子的目录，复用该目录，在其中追加。不得覆盖已有目录。
+- `work_dir` 是当前 Workflow 目录的绝对路径，如 `<工作区>/.cannbot/任务1/workflow1/`。启动时将该路径传给 harness，由框架向子 Agent 提供 `$WORK_DIR`。
+- 每轮启动前，将完整 workflow YAML 写入本轮目录，文件名与目录对应，例如 `workflow1/workflow1.yaml`。引用任务模板时，补充其中缺失字段，将其拼接为完整 YAML 再启动；不得修改已有字段。
+- Workflow 节点输出的所有中间文件名必须为 `<产出节点ID>-<文件名>`，例如 `0.1-黑盒测试设计.md`。同节点的执行与验收报告共用该 ID，上下游引用保持一致。启动前的需求清单与环境检查记录等非调度节点产物，沿用其既定文件名。
+- 仓库级环境记录持久化在 `.cannbot/环境信息.md`，首次检查日志位于 `.cannbot/环境检查/`；本轮采用只读副本。其他本轮输入记录、方案、日志、临时探针、分析文件和报告均放在当前 `work_dir`。最终交付件默认也放在此目录；用户明确要求写入项目中的代码、测试或文档等交付件，在 task 中声明目标路径和写入角色。
+- PM 只在 `.cannbot/` 下写入规划、需求、环境检查、输入快照、workflow YAML 和汇总记录。harness 的 `.workflow/` 状态只读，不自行修改。
+
+## 需求对齐
+
+刚收到需求时，先告知用户：“后面可能需要回答需求问卷，请先不要走开；对齐完成后会通知你。”读取已有说明与必要的工作区上下文，明确目标、范围、约束、输入资料和可判定的交付标准。
+
+只将影响规划或交付的未决事项整理成问卷，问题简短、提供清晰的预设选项，每轮不超过五个问题。已有明确要求、有效确认和授权直接沿用，不重复询问；信息充分时不为了走流程而发问卷。未答复不等于确认，不擅自改变用户约束。
+
+需求及必要的启动信息对齐后，简要说明本轮目标与交付标准，并告知用户：“需求已对齐，你可以离开了，即将开始静默开发；完成后或确实需要你决定时再通知你。”仍有阻断项时不宣告对齐完成。
+
+## 任务规划
+
+1. 按已确认目标选择角色、Skill 与工作流模板，拆分可独立执行和验收的节点，明确依赖、并行关系、交付路径及重试预算。写入同一文件的节点建立依赖，避免并发覆盖。
+2. 由 PM 或 task 显式声明所需 Skill 组合，只注明加载条件、名称及按其要求执行，不复述内部规则。启动前核对调用契约与权限兼容；具体算子能力选择遵循 `ops-direct-invoke` Skill。
+3. 准备原始需求、输入快照、本轮目标与交付位置，将完整 Workflow YAML 写入本轮目录。按 `workflow-orchestrator` Skill 核对 YAML、`work_dir`、`provider`、`prompt` 和角色配置；按该 Skill 要求完成四项输入确认；本轮对相同具体值已有的确认直接复用，不将建议或未答复视为确认。
+4. 通过 harness core 的公开接口下发已落盘的工作流，由框架负责节点派发、并行、执行与验收、重试及状态管理。PM 不另写调度器，不直接操作内部状态。
+
+同一任务可以包含多轮 Workflow。整轮退出后仍有交付缺口时，记录前轮结果、失败依据及下一轮目标，在同一任务目录下新建未使用的 `workflow2/`、`workflow3/` 等目录，只编排必要的修复、补充和重新验收工作。
+
+下一轮明确引用前轮有效产物的绝对路径与版本；需要固定输入文件名时复制有效输入并记录来源，不复制 `.workflow/` 状态。修改前轮交付件时声明授权路径，对受影响的交付要求重新验收，保留前轮 YAML、报告和原始证据。
+
+在用户已授权范围内自主推进，不因新增一轮而重复要求批准。缺少必要信息、权限或外部条件，或没有可行修复方向时，记录并汇报阻塞，不重复相同的无效流程。恢复中断的同一轮时，使用原 YAML、原 `work_dir` 和 harness 的公开恢复接口。
+
+## 执行与交付
+
+启动后尽量静默执行。本轮输入与 Skill 清单保持冻结，子 Agent 不向 PM 或用户提问、等待答复，按任务契约和框架协议记录结果；PM 不在运行中补发指令，新增建议及交付缺口在整轮退出后处理。
+
+运行期间严格遵循 `workflow-orchestrator` Skill 的等待与轮询要求：定期查询会话和任务状态，原样转发轮询输出，即使进度未变化也按其要求转发；遇到待审批节点时按其协议取得用户决定并提交，不自动批准。除此之外，不反复读取日志、报告、源码或中间产物，不追加重复的进度解释，避免无意义的上下文和 token 消耗；仅在异常退出、明确阻塞或用户主动询问时按需读取相关信息。
+
+除调度 Skill 要求的进度转发、审批和结束日志回传外，仅在任务完成、出现无法自主解决的阻塞或确需用户决定时主动通知。沿用已有授权和确认，合并必要问题，不将常规重试、节点切换或已授权的下一轮编排交回用户决策。需要变更范围、接口、验收标准或取得额外权限时，说明具体问题与影响后再询问，不将静默执行理解为可以替用户批准。
+
+整轮退出后再集中读取退出结果、必要的验收报告及交付清单，核对真实交付件是否覆盖用户目标；有缺口时按任务规划推进下一轮。启动成功不代表交付完成，汇总不得改写失败结论。最终向用户简洁交代交付位置、验证结果及仍存在的限制，保留原始日志与各角色报告。
+
+## 权限边界
+
+可以操作：
+
+- 读取必要的工作区上下文，与用户对齐需求。
+- 在 `.cannbot/` 下维护需求、规划、输入快照、Workflow YAML 和汇总记录。
+- 通过 harness 公开接口启动、查询和恢复工作流；取得用户决定后提交必要的审批结果。
+- 整轮退出后读取交付结果、汇总证据，并在已有授权范围内规划下一轮。
+
+不可以操作：
+
+- 代替子 Agent 设计方案、编写最终交付件或执行测试，替其他角色修改验收报告。
+- 绕过 harness 拉起子 Agent，修改 harness 内部脚本或调度状态，在运行中改写本轮输入和 YAML。
+- 删除状态、放宽验收、伪造用户确认或测试结果，或将失败节点擅自标为通过。
+- 超出用户授权范围执行任务或对外操作。

package/assets/ops-direct-invoke/LICENSE

@@ -0,0 +1,38 @@
+CANN Open Software License Agreement Version 2.0
+
+This CANN Open Software License Agreement Version 2.0 (hereinafter referred to as this "Agreement") is a legal agreement between you and Huawei, and it governs your use, modification, or distribution of CANN Open Software (hereinafter referred to as "Software"). Please read this Agreement carefully.
+
+If you are entering into this Agreement on behalf of a company or other legal entity, you represent that you have the legal authority to bind that entity to this Agreement, in which case "you" will mean the entity you represent.
+
+BY DOWNLOADING, INSTALLING, OR USING THE SOFTWARE, YOU AGREE YOU HAVE FULLY UNDERSTOOD AND ACCEPTED THE TERMS CONTAINED HEREIN. IF YOU DO NOT AGREE TO ANY OF THE TERMS OF THIS AGREEMENT, OR IF YOU DO NOT QUALIFY FOR AGREEING TO THIS AGREEMENT, YOU ARE NOT AUTHORIZED TO AND SHALL NOT DOWNLOAD, INSTALL, OR MAKE ANY USE OF THE SOFTWARE.
+
+1. Definition
+
+1.1   Software means the APIs, source code files, binaries, and related documents of Compute Architecture for Neural Networks("CANN") that are licensable by Huawei, and provided and licensed under this Agreement.
+
+1.2   Huawei AI Processors mean AI chipsets (i) branded with "Ascend", "Kirin"," Yueying" or other brands owned or controlled by Huawei; or (ii) manufactured (including have manufactured), supplied (including have supplied) or designed (including have designed) by Huawei.
+
+2.  Grant of Intellectual Property Rights
+2.1 Subject to the terms and conditions of this Agreement, including your full compliance thereof, Huawei hereby grants you a limited, worldwide, royalty-free, non-transferable, non-sublicensable, and revocable license for you to (i) download, use, modify, integrate, and distribute the Software or its derivative works for the purpose of developing software solely for use in systems with Huawei AI Processors and/or Software, and (ii) distribute any software developed based upon Software and/or its derivative works solely for use in systems with Huawei AI Processors and/or Software.
+
+3.  Restrictions
+3.1 You are not authorized to, and shall not use, modify, or distribute this Software or its derivative works for any other purposes than those expressly permitted by this Agreement. You shall not make any use of the Software or its derivative works to develop or distribute any software for use in systems with processors other than Huawei AI Processors. All rights not expressly granted herein are expressly reserved by Huawei.
+
+3.2 You are not authorized to, and shall not remove, obscure, or alter any copyright or other notices in this Software or any part of it.
+
+3.3 Distribution Restrictions
+You may distribute the Software or its derivative works in any medium, whether in source or executable forms, for the purpose stipulated in Section 2; provided that you provide recipients with a copy of this Agreement, and retain all notices in the Software.
+
+4. Disclaimer of Warranty and Limitation of Liability
+THE SOFTWARE IS PROVIDED WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED. IN NO EVENT SHALL HUAWEI OR ANY OTHER COPYRIGHT HOLDER BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING, BUT NOT LIMITED TO ANY DIRECT, OR INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING FROM YOUR USE OR INABILITY TO USE THE SOFTWARE, IN WHOLE OR IN PART, NO MATTER HOW IT IS CAUSED OR THE LEGAL THEORY IT IS BASED ON, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+5. Termination
+5.1 This Agreement will continue to apply until terminated by either you or Huawei as described below:
+a．You may terminate this Agreement by ceasing your use of the Software;
+b.  Huawei may at any time, terminate this Agreement if: (i) you fail to comply with any term of this Agreement; or (ii) you directly or indirectly initiate any legal proceeding against any individual or entity by alleging that the Software or any part of it infringes your intellectual property rights.
+5.2 By termination, all the rights granted to you under this Agreement are terminated, and you shall cease to use and delete this Software or any derivative works immediately. All rights granted to you under this Agreement shall hereby be void ab initio in the event of termination in accordance with Section 5.1. b above. Huawei reserves the right to pursue any and all legal remedies available to enforce the terms and conditions of this Agreement or to protect Huawei’s intellectual property rights for such breach or violation. All provisions shall survive the termination of this Agreement except for Section 2 and Section 3.3.
+
+6. MISCELLANEOUS
+If the application of any provision of this Agreement to any particular facts or circumstances is held to be invalid or unenforceable by a court of competent jurisdiction, then (a) the validity and enforceability of such provision as applied to any other particular facts or circumstances and the validity of other provisions of this Agreement shall not in any way be affected or impaired thereby and (b) such provision shall be enforced to the maximum extent possible so as to affect the intent of the you and Huawei and reformed without further action by you and Huawei to the extent necessary to make such provision valid and enforceable.
+
+END OF THE TERMS AND CONDITIONS

package/assets/ops-direct-invoke/QUICKSTART.md

@@ -0,0 +1,44 @@
+# ops-direct-invoke 快速开始
+
+先准备 Node.js 20.11+、Python 3（含 PyYAML）、tmux 和 Agent 客户端，详见 [环境要求](README.md#环境要求)。以下以 OpenCode 为例；使用 Codex 或 Claude Code 时，将命令中的 `opencode` 换成 `codex` 或 `claude`。
+
+## 普通用户：在工作区用 npx 安装（推荐）
+
+```bash
+cd /path/to/your-workspace
+npx @cannbot-plugin/cannbot install ops-direct-invoke --tool opencode
+```
+
+无需克隆仓库，安装完成即可在当前工作区使用。
+
+## 开发者：克隆仓库，用 init 安装
+
+```bash
+git clone https://gitcode.com/cann/cannbot.git
+cd cannbot
+bash plugins-official/ops-direct-invoke/init.sh project opencode /path/to/your-workspace
+```
+
+init 自动拉取 `cannbot-skills` 同名分支，不存在则用 master。已有本地仓库时，用下面的命令直接软链接复用：
+
+```bash
+bash plugins-official/ops-direct-invoke/init.sh project opencode /path/to/your-workspace \
+  --skills /path/to/cannbot-skills
+```
+
+## 开始使用
+
+在目标工作区启动客户端：
+
+```bash
+cd /path/to/your-workspace
+opencode
+```
+
+向 Agent 提出需求：
+
+> 请使用 ops-direct-invoke 开发一个 abs 算子，开发语言为 Ascend C 直调。
+
+按提示补充需求，完成后查看 Agent 的交付说明；运行记录在工作区 `.cannbot/` 下。
+
+指定 SHA、安装参数、版本记录等完整说明见 [README](README.md#安装详解)。

package/assets/ops-direct-invoke/README.md

@@ -0,0 +1,219 @@
+# ops-direct-invoke
+
+## 新特性
+
+### 【2026-09-30】
+
+- 新增 **CANNBot-DSL 算子开发支持**：按开发语言选择 DSL 工作流，支持设计、动态实现子图生成、开发与验收。
+- DSL 的环境节点检查环境后生成对应 wheel 的 API 参考；性能优化完成后再生成最终版本的文档。
+- 提供 `ops-direct-invoke-maintain`，按模块记录工作流设计与维护约定。
+- 回归测试随维护 Skill 分发，修改工作流后运行完整测试；检查自身脚本和 harness 调用衔接，不重复验证框架内部调度。
+- 安装与使用统一见 [QUICKSTART.md](QUICKSTART.md)。
+
+## 功能概览
+
+`ops-direct-invoke` 提供直调算子的需求对齐、方案设计、实现、功能验收、代码检视和交付文档流程。插件名称、安装 ID 与入口 Skill 名称统一为 `ops-direct-invoke`。
+
+**调度交给 harness，知识交给 Skill，Workflow 专注于流程。** 工作区 PM 按用户的实际目标规划子 Agent 合作，通过 harness 执行 workflow YAML。算子需求对齐时必须加载 `repo-requirement` Skill，按其中的要求执行；算子开发时必须加载 `ops-direct-invoke` Skill，按其中的要求执行。每个 task 同时声明执行与验收；运行期派发、并行及同节点重试使用框架原生机制。
+
+安装与首次使用见 [QUICKSTART.md](QUICKSTART.md)。
+
+## 安装详解
+
+普通用户推荐在目标工作区使用 `npx` 安装；开发者推荐克隆源码后运行插件的 `init.sh`。两种方式的最短操作步骤见 [快速开始](QUICKSTART.md)。
+
+### 环境要求
+
+需要 Node.js 20.11+、Python 3、PyYAML 和已安装并配置好的 Agent CLI。默认后台启动还需要 tmux；工作流运行依赖支持 `procedure` 字段的 workflow-orchestrator，由安装器一并安装。目前工作流验证的客户端为 OpenCode、Codex、Claude Code；统一安装器还提供 TRAE、DSH 安装选项。
+
+### 安装入口与目标目录
+
+`npx @cannbot-plugin/cannbot install ops-direct-invoke --tool opencode` 默认安装到当前目录，也可通过 `--target /absolute/workspace` 指定目标。npm 安装复制包内完整 Skill 资源，不需要克隆源码或下载 cannbot-skills 子模块。
+
+源码安装在插件目录执行：
+
+```bash
+bash init.sh [project] [opencode|codex|claude|trae|dsh] [install_path] [--skills <SHA|path>]
+```
+
+默认客户端为 opencode；省略 `install_path` 时安装到 cannbot 仓根，而不是当前执行目录。只支持 project 级安装，每次安装一种客户端，多个客户端分别执行。参数帮助见 `bash init.sh --help`。init 调用的统一 CLI 也可在 cannbot 根目录直接使用：
+
+```bash
+node script/bin/cannbot.js install ops-direct-invoke \
+  --source "$PWD" --tool codex --target /absolute/workspace
+```
+
+### 公共 Skills 来源与版本
+
+源码安装默认自动初始化 `vendor/cannbot-skills`，每次从其 `origin` 获取与 cannbot 当前分支同名分支的最新提交及其嵌套子模块。远端没有同名分支，或 cannbot 处于 detached HEAD 时，使用 `master`。不会自动更新 cannbot 主仓。
+
+| init 参数 | 行为 |
+|---|---|
+| 不传 `--skills` | 获取 cannbot-skills 同名分支最新提交，不存在则回退 master |
+| `--skills <SHA>` | 选择指定提交；缺失提交须使用完整 SHA，本地已有提交可使用 7 位以上短 SHA |
+| `--skills /absolute/cannbot-skills` | 直接链接本地 Git 工作树中的 Skills，不联网或更新 vendor 子模块 |
+
+已有路径优先按本地仓识别，必须为含所需 Skills 的 Git 工作树根目录；相对路径以执行命令的目录为基准。本地仓未提交内容会保留，并记录 dirty 标志。显式 `--skills` 跳过默认分支选择。默认或 SHA 模式遇到子模块未提交修改、远端查询或拉取失败、缺少所需 Skill 时停止安装；查询失败不当作分支缺失触发回退。最新依赖与工作流声明不兼容时，可指定兼容 SHA 或本地检出。`--skills` 只适用于声明公共依赖的源码安装，npm 打包安装不接受此参数。
+
+客户端配置目录的 `cannbot-plugin.json`（例如 `.codex/cannbot-plugin.json`）记录 `source.revisions`：主仓 SHA、公共仓实际完整 SHA、选择方式、请求值、dirty 状态及本地来源路径。默认模式记录 `selection: "latest-branch"`，`requested` 为实际选中的分支名（回退时为 `master`）。同一插件重装会更新记录。公共字段定义和跨工作流适用范围见 [统一安装指南](../../script/docs/cannbot-workflows.md#安装方式)。
+
+源码安装使用软链接，指定 SHA 也只固定本次选择；以后修改或更新共享工作树，会影响之前安装的项目。版本记录不是内容快照，dirty 内容不能仅由 SHA 复现。需要多个项目使用不同版本时，用独立 checkout 并分别指定 `--skills <path>`。更新 vendor 后，主仓可能显示子模块 HEAD 与 gitlink 不一致。
+
+### 工作区资产与定制
+
+项目指引写入 `AGENTS.md`（Claude 使用 `CLAUDE.md`），角色与 Skill 路径见安装记录。源码 Skill 的修改会通过软链接生效；项目指引和角色配置是生成文件，修改源文件后需重新安装同步。
+
+子仓可在统一 CLI 命令后添加 `--override-skills /absolute/overrides`，用该目录下的同名实现替换已有 `repo-*` Skills。入口及调度 Skill 不允许覆盖。此参数用于替换仓库知识，`--skills` 用于选择公共 cannbot-skills 仓，两者用途不同。
+
+### 任务输入与恢复
+
+使用 CANNBot-DSL 时明确开发语言，并提供目标 wheel、目标芯片和相关需求资料。PM 先对齐缺失信息，再选择 AscendC basic、独立 feasibility 或 DSL op-dev 流程。
+
+每轮 YAML、日志和交付记录位于 `.cannbot/<任务名>/workflow<序号>/`。恢复同一轮时沿用原 YAML 和工作目录，通过 harness 公开恢复接口执行；新一轮修复使用新目录，不删除或复制旧调度状态。手动组装与启动参数见 [算子流程入口](skills/ops-direct-invoke/SKILL.md)。
+
+## 设计思想与入口
+
+插件的 [AGENTS.md](AGENTS.md) 是常驻工作区的通用 PM 指引，直接描述需求拆解、子 Agent 协作、工作流启动与多轮交付，不再通过 PM 角色文件转接。初始化时，安装器将其正文写入工作区 `AGENTS.md` 的插件管理区块，保留用户原有内容；Claude 使用 `CLAUDE.md`。重复初始化替换同一管理区块，不重复追加。
+
+算子开发任务由 PM 加载 `ops-direct-invoke` Skill，按其中的要求执行。所有子 Agent 必须在 Workflow YAML 落盘后由 harness 拉起。`agents/` 只保留 `ops-direct-invoke-architect`、`ops-direct-invoke-developer`、`ops-direct-invoke-verifier` 三个真实 Agent，分别安装为 Codex 的 TOML 或 OpenCode、Claude 的 Markdown 角色配置。CANNBot-DSL 的“环境检查”“需求分析”“黑盒设计”“代码检视”等是节点职责，不是独立 Agent；静态工作流与动态实现子图的 `executor`/`verifier` 必须引用上述三个完整角色名，未知角色会在生成时拒绝。
+
+每个任务、每轮 Workflow 独立存放 YAML 和运行记录：
+
+```text
+.cannbot/任务1/
+├── workflow1/
+│   ├── workflow1.yaml
+│   ├── 需求与交付件
+│   └── .workflow/
+└── workflow2/
+    ├── workflow2.yaml
+    ├── 本轮输入与交付件
+    └── .workflow/
+```
+
+仓库首次环境检查结果存放在 `.cannbot/环境信息.md`，检查日志存放在 `.cannbot/环境检查/`。后续算子开发直接复用已有通过记录，不重复探测环境；每轮复制为 `work_dir/环境信息.md`，运行中只读。
+
+当前 Workflow 目录的绝对路径即 `work_dir`。首轮未满足交付要求时，PM 根据缺口规划下一轮，保留旧 YAML、状态及验收证据。下一轮明确引用或复制有效输入，并重新验收受影响交付件；同一轮中断恢复则沿用原目录和原 YAML。
+
+## 从需求到执行
+
+- 需求对齐：必须加载 [repo-requirement](skills/repo-requirement/SKILL.md) Skill，按其中的要求执行。
+- 启动前环境检查由 PM 负责：必须加载 [repo-env-check](skills/repo-env-check/SKILL.md) Skill，按其中的要求执行。
+- 算子开发：必须加载 [ops-direct-invoke](skills/ops-direct-invoke/SKILL.md) Skill，按其中的要求执行。
+- Workflow 执行：必须加载 [workflow-orchestrator](../../harness/workflow-orchestrator/SKILL.md) Skill，按其中的要求执行。
+
+## 默认流程与角色
+
+需求确认与 PM 环境检查在工作流启动前完成。PM 先核对路线依据和 Skill 调用契约；路线明确时使用 basic，有关键实现疑点时先独立运行 [feasibility](skills/ops-direct-invoke/workflows/ascendc/feasibility.yaml)。穿刺交付最小代码、代表用例的真实编译与设备证据，通过后新开一轮 basic；规则冲突先澄清，不靠穿刺绕过。basic 默认包含 7 个普通节点，知识搜集可以省略或用前轮资料替代；仓内没有已有算子文档时，下发前从本轮图省略最后的文档准备节点：
+
+```mermaid
+flowchart TD
+    K[0.0 知识搜集] --> T[1 测试工程开发]
+    B[0.1 黑盒测试设计] --> T
+    T --> D[2 算子开发]
+    D --> W[3 白盒测试设计与用例接入]
+    W --> R[4 代码修复]
+    R --> U[5 文档准备：仅仓内已有算子文档时]
+```
+
+知识搜集形成中立补充文档，包含资料索引、API 组合和不同 shape 的初版 Tiling 草稿，开发可根据验证调整实现。算子开发通过 `knowledge_documents` 接收本轮或前轮文档路径；无资料时使用默认值“无补充文档。”，不要求工作流存在知识搜集节点。省略知识节点时删去相应依赖，将黑盒设计编号改为 `0`、测试工程依赖改为 `0`，同步更新知识文档变量，其他阶段仍为 `1`～`5`。测试工程先准备黑盒，算子实现后再按源码生成白盒用例并直接接入已有框架。白盒节点检查测试质量与证据，发现的算子缺陷交给默认编排的代码修复节点；代码修复要求全量黑盒、白盒回归及代码检视通过，没有缺陷且已有当前版本的有效全量证据时复用并记录依据，不强制重复构建或测试；证据缺失或失效时补齐验证。
+
+[generate_workflow_guide.py](skills/ops-direct-invoke/scripts/generate_workflow_guide.py) 扫描模板并生成本轮 `workflow-guide.csv`，列出模板文件名和调用时机。PM 先生成并读取引导，再打开匹配模板。调用时机由各模板第二行的 `use_when` 维护，组装后不传给 harness。basic 与 feasibility 各自维护引用图，每个节点声明 id、task YAML、depends_on、max_retries，以及 task 需要的 variables 赋值。task 内容由组装脚本读取并展开，默认每个节点允许 3 次重试（含首次执行最多 4 轮），重试次数由 PM 在下发时确定。固定必需 Skill 保留在 task；PM 仅对声明了 `executor_skills`、`verifier_skills` 的 task 下发专项必需项，以及开发、修复阶段的有限候选清单与触发条件。节点按实际证据选用候选并记录依据，必需能力缺口或已确认约束、范围变更需求写入报告，交付标准无法满足时验收失败。运行中不与 PM 或用户交互；PM 在整轮退出后处理阻塞及知识搜集建议，供下一轮编排使用，不修改已启动的 YAML。AscendC 的文档准备按仓内已有格式补全资料，无已有算子文档时可省略该节点；DSL 文档节点按其交付契约生成本轮文档。入口 [SKILL.md](skills/ops-direct-invoke/SKILL.md) 规定模板选择与使用方法。
+
+| 角色 | 职责 |
+|---|---|
+| [工作区 PM](AGENTS.md) | 理解用户目标、规划协作与多轮交付；不进入 task 图 |
+| [ops-direct-invoke-architect](agents/ops-direct-invoke-architect.md) | 需求、规格、黑盒设计、方案、实现规划与任务拆分 |
+| [ops-direct-invoke-developer](agents/ops-direct-invoke-developer.md) | 工作区、环境、代码实现与修复、精度和性能验证、文档及交付 |
+| [ops-direct-invoke-verifier](agents/ops-direct-invoke-verifier.md) | 需求/规格/方案/设计与通用验收，以及代码检视；不重复构建或运行测试 |
+
+节点通过 `executor` / `verifier` 名称引用安装后的客户端角色，不在 prompt 中额外读取角色文件。工作区常驻指引与运行期子 Agent 派发是两个层次；实际 provider 是否正确加载角色、Skill 和权限仍需真实调用验证。
+
+执行者提供原始构建日志、本阶段测试结果（穿刺代表用例、正式交付全量）、源码/测试/构建产物哈希及实际加载路径，使用 [测试执行记录模板](skills/ops-direct-invoke/templates/测试执行记录.md)。验收者核对证据是否真实、完整、对应当前版本并独立检视代码；证据不足则失败，不代跑测试补证据。所有节点均按 [验收报告模板](skills/ops-direct-invoke/templates/验收报告.md) 生成 `<节点ID>-验收报告.md`，其中记录结论及具体修改意见。共享 acceptance 只列执行者交付件；验收报告由 verifier 在 procedure 中生成并检查，executor 根据回传反馈按需读取详情，不代写或等待它。
+
+穿刺代码、测试入口及证据通过本轮任务 prompt 传入下一轮，并明确使用节点，知识资料通过 `knowledge_documents` 传入；记录绝对路径、版本及适用范围，复用有效产物而非重复调查。穿刺通过仅证明限定范围可行，正式交付仍须全量测试和代码检视。
+
+报告保留关键结论和证据路径，每次真实执行的输入/版本清单、原始日志与用例明细只存一份；后续节点引用并核对差异，每个验收者仍独立出具本阶段报告。返工依据 harness 回传的失败摘要，按需读取所引用报告的未解决项，并补充变更证据；版本变化使旧证据失效时重新验证。确定性阻塞未变时只记录条件复核，当前 harness 仍按预算重试，不能凭报告自动跳过重试。
+
+固定绑定采用与当前节点契约兼容的仓库能力：工程骨架由 `repo-op-templates` 承担，白盒方法由 `repo-test-develop` 承担。`ascendc-direct-invoke-template` 和 `ascendc-whitebox-design` 不再是默认任务的固定项；安装可用不等于必须调用。PM 为补充项核对完整契约，不向禁止交互和派发的节点绑定仍要求这些操作的 Skill，也不靠局部豁免后强行调用。
+
+公共 Skill 的规则由来源仓维护；本插件只调整绑定与流程，不复制或覆盖其规则。已知 Ascend 950 路由组合问题见 [cannbot-skills #688](https://gitcode.com/cann/cannbot-skills/issues/688)。
+
+## 任务、模板与运行接口
+
+必须加载 [ops-direct-invoke](skills/ops-direct-invoke/SKILL.md) Skill，按其中的要求执行。
+
+- [任务定义](skills/ops-direct-invoke/tasks/)
+- [引导生成脚本](skills/ops-direct-invoke/scripts/generate_workflow_guide.py)
+- [文档模板](skills/ops-direct-invoke/templates/)
+- [组装脚本](skills/ops-direct-invoke/scripts/assemble_workflow.py)
+- [启动脚本](skills/ops-direct-invoke/scripts/run_workflow.py)
+
+## 知识与范围
+
+Skill 正文及 references 仅包含自身职责，不互相调用或路由；跨 Skill 组合由 PM 或 task 的 approach/procedure 显式声明。引用处只保留加载条件、Skill 名称及按其要求执行，不复制内部步骤或规则。节点输入、产物路径和验收结果由 task 声明；资源目录引用用于定位文件，不代表调用其所属 Skill。公共领域 Skill 来自 vendor，harness 和统一安装器作为公共基础设施使用。
+
+角色、task、脚本、仓库知识及交付模板均由本插件独立维护，安装与运行使用本目录声明的资产及公共依赖。
+
+本仓 `repo-*` 知识按 CANN Bench 的直调工程与评测契约组织，包含需求、环境、接口、模板、构建、测试和编码规则。初始化会获取 `cann-bench` 到 `.cannbot/dependencies/ops-direct-invoke/cann-bench/`，实际运行记录所用 commit；已有 checkout 可作为任务输入复用。跨仓定制继续通过同名 `repo-*` Skill 覆写，不将仓库知识复制进 task。
+
+AscendC basic 的范围为本地开发、功能验收与交付文档；DSL op-dev 还包含性能采集、优化及回归。两者均不包含 PR、外部 CI 或合并。需求阶段仍需如实记录性能诉求；用户要求的硬门槛超出当前执行范围时，先对齐交付安排，不能承诺本流程已验证性能。引用业务知识时不启用其中遗留的 PM 派发、状态维护或回退指令。
+
+## 维护与验证
+
+修改相关组件前加载 [ops-direct-invoke-maintain](skills/ops-direct-invoke-maintain/SKILL.md)，按模块资料维护设计，并检查 README 与 QUICKSTART 一致性。
+
+每次工作流改动后，在应用仓根目录完整运行：
+
+```bash
+python3 plugins-official/ops-direct-invoke/skills/ops-direct-invoke-maintain/test/ut/test_all.py
+```
+
+回归需要 Python 3.9+、PyYAML 和 harness，不调用真实模型或 NPU。安装后可从实际 Skill 目录调用同一入口：默认使用同级安装的 harness，源码仓使用应用仓的 harness；其他布局通过 `--harness-skill /absolute/workflow-orchestrator` 指定。测试在临时目录运行，不需要 tmux，可从任意当前目录启动。
+
+测试验证引导、组装、变量、DSL 设计与子图生成，以及启动参数和全部模板到 harness 的接口冒烟。harness 作为可信依赖，不在插件中重复测试重试、回滚与反馈状态机；也不固定节点数量、Skill 数量、业务顺序或提示词措辞。测试设计与边界见 [测试体系](skills/ops-direct-invoke-maintain/reference/tests.md)。测试通过不代表真实 Agent 行为或 NPU 算子验证已通过。
+
+安装与打包集成测试仍位于应用仓 `script/test/`，不属于本次迁移的插件回归测试。
+
+## 目录与接口
+
+```text
+ops-direct-invoke/
+├── AGENTS.md                       # 工作区 PM 的通用指引
+├── README.md                       # 新特性、设计与功能
+├── QUICKSTART.md                   # 安装与使用
+├── agents/                         # architect / developer / verifier
+├── init.sh                         # 统一安装器的薄入口
+├── skills/                         # 自带 Skills 和公共 Skill 相对软链接
+├── plugin-install.json             # 外部依赖仓声明
+└── skills/
+    ├── ops-direct-invoke-maintain/
+    │   ├── SKILL.md                 # 维护入口与完整回归要求
+    │   ├── reference/               # 模块设计与维护方法
+    │   └── test/ut/                 # 所有维护回归测试
+    ├── repo-env-check/             # PM 的启动前环境检查
+    ├── repo-requirement/
+    │   ├── SKILL.md
+    │   └── references/requirement-checklist.md
+    ├── ops-direct-invoke/
+    │   ├── SKILL.md                 # 先生成引导，再选用模板
+    │   ├── scripts/
+    │   │   ├── generate_workflow_guide.py
+    │   │   ├── assemble_workflow.py
+    │   │   └── run_workflow.py
+    │   ├── tasks/
+    │   │   ├── ascendc/             # <步骤名>.yaml，不带编号
+    │   │   ├── cannbot-dsl/
+    │   │   └── common/
+    │   ├── workflows/
+    │   │   ├── cannbot-dsl/          # op-dev 主图与展示资料
+    │   │   └── ascendc/
+    │   │       ├── basic.yaml       # 正式开发，含 use_when
+    │   │       └── feasibility.yaml # 独立技术穿刺，含 use_when
+    │   └── templates/              # 文档模板平铺，文件名不带编号
+    ├── repo-knowledge/
+    ├── repo-build-guide/
+    ├── repo-op-templates/
+    ├── repo-coding-rules/
+    └── repo-test-develop/
+```

package/assets/ops-direct-invoke/SKILLS_LICENSE

@@ -0,0 +1,38 @@
+CANN Open Software License Agreement Version 2.0
+              
+This CANN Open Software License Agreement Version 2.0 (hereinafter referred to as this "Agreement") is a legal agreement between you and Huawei, and it governs your use, modification, or distribution of CANN Open Software (hereinafter referred to as "Software"). Please read this Agreement carefully.
+
+If you are entering into this Agreement on behalf of a company or other legal entity, you represent that you have the legal authority to bind that entity to this Agreement, in which case "you" will mean the entity you represent.
+
+BY DOWNLOADING, INSTALLING, OR USING THE SOFTWARE, YOU AGREE YOU HAVE FULLY UNDERSTOOD AND ACCEPTED THE TERMS CONTAINED HEREIN. IF YOU DO NOT AGREE TO ANY OF THE TERMS OF THIS AGREEMENT, OR IF YOU DO NOT QUALIFY FOR AGREEING TO THIS AGREEMENT, YOU ARE NOT AUTHORIZED TO AND SHALL NOT DOWNLOAD, INSTALL, OR MAKE ANY USE OF THE SOFTWARE.
+
+1. Definition
+
+1.1   Software means the APIs, source code files, binaries, and related documents of Compute Architecture for Neural Networks("CANN") that are licensable by Huawei, and provided and licensed under this Agreement.
+
+1.2   Huawei AI Processors mean AI chipsets (i) branded with "Ascend", "Kirin"," Yueying" or other brands owned or controlled by Huawei; or (ii) manufactured (including have manufactured), supplied (including have supplied) or designed (including have designed) by Huawei.
+
+2.  Grant of Intellectual Property Rights
+2.1 Subject to the terms and conditions of this Agreement, including your full compliance thereof, Huawei hereby grants you a limited, worldwide, royalty-free, non-transferable, non-sublicensable, and revocable license for you to (i) download, use, modify, integrate, and distribute the Software or its derivative works for the purpose of developing software solely for use in systems with Huawei AI Processors and/or Software, and (ii) distribute any software developed based upon Software and/or its derivative works solely for use in systems with Huawei AI Processors and/or Software. 
+
+3.  Restrictions
+3.1 You are not authorized to, and shall not use, modify, or distribute this Software or its derivative works for any other purposes than those expressly permitted by this Agreement. You shall not make any use of the Software or its derivative works to develop or distribute any software for use in systems with processors other than Huawei AI Processors. All rights not expressly granted herein are expressly reserved by Huawei.
+
+3.2 You are not authorized to, and shall not remove, obscure, or alter any copyright or other notices in this Software or any part of it.
+
+3.3 Distribution Restrictions 
+You may distribute the Software or its derivative works in any medium, whether in source or executable forms, for the purpose stipulated in Section 2; provided that you provide recipients with a copy of this Agreement, and retain all notices in the Software.
+
+4. Disclaimer of Warranty and Limitation of Liability
+THE SOFTWARE IS PROVIDED WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED. IN NO EVENT SHALL HUAWEI OR ANY OTHER COPYRIGHT HOLDER BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING, BUT NOT LIMITED TO ANY DIRECT, OR INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING FROM YOUR USE OR INABILITY TO USE THE SOFTWARE, IN WHOLE OR IN PART, NO MATTER HOW IT IS CAUSED OR THE LEGAL THEORY IT IS BASED ON, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+5. Termination
+5.1 This Agreement will continue to apply until terminated by either you or Huawei as described below:
+a．You may terminate this Agreement by ceasing your use of the Software;
+b.  Huawei may at any time, terminate this Agreement if: (i) you fail to comply with any term of this Agreement; or (ii) you directly or indirectly initiate any legal proceeding against any individual or entity by alleging that the Software or any part of it infringes your intellectual property rights.
+5.2 By termination, all the rights granted to you under this Agreement are terminated, and you shall cease to use and delete this Software or any derivative works immediately. All rights granted to you under this Agreement shall hereby be void ab initio in the event of termination in accordance with Section 5.1. b above. Huawei reserves the right to pursue any and all legal remedies available to enforce the terms and conditions of this Agreement or to protect Huawei’s intellectual property rights for such breach or violation. All provisions shall survive the termination of this Agreement except for Section 2 and Section 3.3.
+
+6. MISCELLANEOUS
+If the application of any provision of this Agreement to any particular facts or circumstances is held to be invalid or unenforceable by a court of competent jurisdiction, then (a) the validity and enforceability of such provision as applied to any other particular facts or circumstances and the validity of other provisions of this Agreement shall not in any way be affected or impaired thereby and (b) such provision shall be enforced to the maximum extent possible so as to affect the intent of the you and Huawei and reformed without further action by you and Huawei to the extent necessary to make such provision valid and enforceable.
+
+END OF THE TERMS AND CONDITIONS