oprun-skills 1.4.0 → 1.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/INSTALL.md CHANGED
@@ -1,59 +1,81 @@
1
1
  # 安装或更新 OpRun
2
2
 
3
- 用户说“安装 OpRun”或“更新 OpRun”时,执行以下简短流程。阅读入口为 https://github.com/TeamSillyBees/oprun-skills/blob/main/INSTALL.md,使用网页读取工具时不要访问 Release 附件下载地址,GitHub 可能将其强制作为二进制附件返回。默认使用最新正式 Release,不用移动的 main 作为安装版本。
3
+ 用户说“安装 OpRun”或“更新 OpRun”时,先按当前客户端能力选择方式,保留已有配置,再检查连接。说明入口是 https://github.com/TeamSillyBees/oprun-skills/blob/main/INSTALL.md;说明可随 main 更新,实际安装必须固定到正式版本。
4
4
 
5
- 1. 先核对当前会话工具、宿主和已有连接。Qveris 中已保存连接还需在“本对话已启用”中勾选 oprun;不要用反复搜索替代连接检查。没有命令执行或文件写入能力时,直接使用宿主原生 ZIP 导入。
6
- 2. 有 Node.js 22+ 时执行 `npx oprun-skills@latest install --host <宿主>`,更新使用 `update`,检查使用 `doctor`。支持 codex、claude、qveris、workbuddy、generic。工具携带固定版本的完整 Skill,校验每个文件;不依赖 Python,不启动本地业务服务。`npx` 首次可能要求确认下载官方 npm 包。
7
- 3. 默认只写当前项目。Codex 使用 `.agents/skills/oprun-project-planning`,Claude Code 使用 `.claude/skills/oprun-project-planning`。只有项目标记唯一时自动识别;不确定时输出原生导入说明。桌面宿主导入同版本 ZIP;仅当宿主公开支持目录时使用 `--target <完整Skill目录>`,目录名须为 `oprun-project-planning`。不猜测应用私有数据库位置。
8
- 4. 复用已有 MCP 连接。工具只输出公开配置,不改写宿主配置;需要时使用原生导入。只读用途加 `--readonly`,已有授权不自动扩大。用户本人完成首次 OAuth;再在客户端调用 `tools/list`、`oprun_account_context` 检查授权和工具。不得查询项目或执行业务操作来验证安装。
9
- 5. `doctor` 检查公开 OAuth 发现及本地安装记录,发现成功不代表登录或工具调用成功。`--offline` 仅核对文件;`update_available` 表示已安装版本早于当前 CLI 所携版本,不表示已完成更新。桌面宿主的导入状态需在其原生界面核对。
5
+ ## 先选择安装方式
10
6
 
11
- npm 注册表不可用时,可执行 `npx https://github.com/TeamSillyBees/oprun-skills/releases/latest/download/oprun-skills.tgz install --host <宿主>`,更新时将 `install` 换成 `update`。使用固定版本可把 URL 中的 `latest/download` 改成 `download/v<版本>`。
7
+ 先查看当前会话已有的工具、宿主和 OpRun 连接,不让用户选择 npm 或 ZIP 等技术方案,不根据客户端名称猜测执行能力。
12
8
 
13
- 没有 Node.js 时仍可导入 ZIP。既有 Python 安装方式保留:从同一固定 Release 下载并校验 `install.py`、`manifest.json` 和 `SHA256SUMS`,用 Python 3.9+ 执行 `python3 install.py install|update|check`。不要使用 curl 管道直接运行下载脚本。
9
+ | 当前能力 | 直接采用的方式 |
10
+ | --- | --- |
11
+ | 能执行命令、写入获准 Skill 目录,且已有 Node.js 22+ | npm/npx 安装或更新 |
12
+ | 没有命令工具、没有文件写入能力、Node.js 不可用,或命令被宿主限制 | 原生 ZIP 导入,不要求用户安装 Node.js、Python 或打开终端 |
13
+ | 能运行命令,但桌面宿主未公开 Skill 安装目录 | 原生 ZIP 导入,不修改应用私有目录或数据库 |
14
+ | 客户端不支持 Skill 导入 | 明确说明不能安装 Skill;若支持 MCP,可继续复用或配置连接,不能称为 Skill 已安装 |
14
15
 
15
- 只有实际完成相应步骤才能报告“已安装/已更新、已连接”。等待用户登录或原生导入时说明具体一步;不把脚本测试当作客户端真实验收。
16
+ 工具列表已能确定能力时不做无效尝试。命令安装因能力不足失败一次后转 ZIP,不反复尝试命令,也不用联网搜索工具代替文件写入。网络故障或文件校验失败需如实说明,不能通过改用 ZIP 绕过校验。
16
17
 
17
- 再次更新沿用同一流程,不重建连接、不删除用户配置。工具输出 backup 是恢复目录;npm 更新备份放在 Skill 扫描目录外的 `oprun-skill-backups`。需要恢复时先比较两边安装记录和文件摘要,备份当前目录,再将 backup 下的完整 Skill 目录放回原 target;不能覆盖新的本地修改。早期非托管安装只读比较;内容有差异时先保存、核对,不强行覆盖。
18
+ ## ZIP 安装与更新
18
19
 
19
- 安装说明获取失败时:若网页读取工具拒绝 `application/octet-stream`,改读 https://github.com/TeamSillyBees/oprun-skills/blob/main/INSTALL.md;仍无法读取时使用 GitHub Contents API 的 INSTALL.md(content 为 Base64)。同一错误不重复请求。说明入口可跟随 main,实际安装包始终固定正式 Release 标签。
20
+ 1. 读取[最新正式发布](https://github.com/TeamSillyBees/oprun-skills/releases/latest),确定具体版本,提供该版本的 `oprun-project-planning.zip` 下载链接。不要提供仓库的 Source code ZIP,也不要把二进制 ZIP 交给正文读取工具。如果无法解析版本,提供[官方 ZIP 下载入口](https://github.com/TeamSillyBees/oprun-skills/releases/latest/download/oprun-project-planning.zip),标明“版本待核实”,不编造版本号。
21
+ 2. 根据已知客户端,只给一条具体导入路径。Qveris 已核验路径为“添加技能 → 上传 ZIP”,选择文件后“导入技能”,再在对话中选择 `oprun-project-planning`;已有 oprun 连接需在“本对话已启用”中启用。WorkBuddy 使用其当前页面的 Skill 安装/导入入口;若无法看到该入口或没有可靠文档,只询问入口位置,不编造按钮名称。能安全下载到获准目录时可代为下载;不能下载时让用户点击链接。不擅自打开或操作用户窗口。
22
+ 3. 更新使用客户端的原生更新或替换方式。保留既有 MCP 连接、配置、授权、会话及用户自定义内容,不先卸载旧 Skill,不反复导入同名副本。若客户端只能重复新增,先说明这一限制;有本地改动时先导出或备份并核对,不能直接覆盖。可靠核对到 Skill 文件完全一致时,无需重复导入。
23
+ 4. 宿主不能自动导入时,简短提示“请下载并导入 ZIP,完成后告知结果”,状态为“等待导入确认”。客户端显示导入成功或用户确认后,再检查 Skill 是否在当前会话启用;仅下载完成不能报告已安装。不能读取已安装版本时明确“已导入,版本待客户端核实”。
20
24
 
21
- 以下为宿主差异和排错参考,无需逐条展示给用户。
25
+ 对无命令能力的客户端,首次引导只需要:下载链接、当前宿主的导入步骤,以及“已有连接会保留”。不要再展示 npm 命令、要求用户配置开发环境或索取凭据。能够读取二进制文件的工具应按同版本 `manifest.json` 和 `SHA256SUMS` 核对 ZIP;做不到时使用官方链接并标明“文件摘要未核验”,不声称已校验。
22
26
 
23
- ## 客户端适配
27
+ ## 命令安装与更新
24
28
 
25
- | 客户端 | 安装位置与连接方式 |
26
- | --- | --- |
27
- | Codex | 当前项目 `.agents/skills/oprun-project-planning`;连接采用本机 CLI 帮助所支持的 MCP OAuth 方式 |
28
- | Claude Code | 当前项目 `.claude/skills/oprun-project-planning`;使用宿主 MCP OAuth 配置 |
29
- | Qveris | 原生导入完整 ZIP;导入 [专用配置](skills/oprun-project-planning/assets/qveris-mcp.json),点击“保存并授权” |
30
- | WorkBuddy | 原生安装完整 Skill;导入 [专用配置](skills/oprun-project-planning/assets/workbuddy-mcp.json),点击“连接” |
31
- | 其他 | 先核实宿主支持 Skill、Streamable HTTP、OAuth S256 PKCE;用原生安装与连接方式 |
29
+ ```sh
30
+ npx oprun-skills@latest install --host <宿主>
31
+ npx oprun-skills@latest update --host <宿主>
32
+ npx oprun-skills@latest doctor --host <宿主>
33
+ ```
34
+
35
+ 支持 codex、claude、qveris、workbuddy、generic。只有项目标记唯一时可省略 `--host` 自动识别;多个标记不猜测。默认项目范围:Codex 为 `.agents/skills/oprun-project-planning`,Claude Code 为 `.claude/skills/oprun-project-planning`。全局安装仅在用户要求时使用已公开的目录。
32
36
 
33
- 默认项目范围。全局安装只在用户明确要求时使用宿主文档中的目录。脚本不编辑宿主私有数据库、Token 存储或其他 MCP 配置。仅有 `.agents` 或 `.claude` 标记时可自动识别;桌面客户端及多个标记时由 Agent 根据当前宿主选 `--host`,无需让用户猜路径。
37
+ 工具输出 `awaiting_host_import` 表示还没有完成安装,转入上面的 ZIP 流程。桌面宿主只在已公开支持目录时使用 `--target <完整Skill目录>`,目录名须为 `oprun-project-planning`。`npx` 首次可能要求确认下载包,遵循宿主提示。
34
38
 
35
- 正式下载入口为 `https://github.com/TeamSillyBees/oprun-skills/releases/latest`。先解析实际标签,所有文件从同一标签下载。`install.py`、ZIP 必须分别通过该版本清单和 SHA256SUMS 校验;摘要证明完整性,可信来源仍是官方仓库 HTTPS。没有 Python 时使用 npm 工具或宿主原生 ZIP 安装;不要让用户安装开发环境才能连接。
39
+ 更新使用当前正式版;一旦解析出版本,本次安装、更新、检查和下载均使用同一版本(例如 `oprun-skills@<版本>`),不混用变动的 latest。npm 和 GitHub 发布不同步时,分别说明可用版本,不把旧包称为新版。
36
40
 
37
- ## 登录和权限
41
+ npm 注册表不可用时,可使用同版本 GitHub 包:`npx https://github.com/TeamSillyBees/oprun-skills/releases/download/v<版本>/oprun-skills.tgz install --host <宿主>`;更新改用 `update`。没有命令能力时不展示这个备用命令,直接走 ZIP。
38
42
 
39
- 地址和 OAuth issuer 均为 `https://www.agi.yifx.vip/mcp`。Qveris 必须显式使用 `authMode: oauth`、该 issuer 和配置中的 Scope;不填写 `openid offline_access`。详细差异按需阅读 [Qveris 指引](skills/oprun-project-planning/references/qveris.md)、[WorkBuddy 指引](skills/oprun-project-planning/references/workbuddy.md)及[多宿主指引](skills/oprun-project-planning/references/hosts.md)。
43
+ 已有 Python 安装方式继续保留:从同一固定 Release 下载并校验 `install.py`、`manifest.json`、`SHA256SUMS`,用 Python 3.9+ 执行 `python3 install.py install|update|check`。不要使用 curl 管道直接运行下载脚本。
40
44
 
41
- 用户明确要连接完整功能时采用统一配置;仅查看时采用只读配置。意图不明时在 OAuth 授权页由用户选择,不悄悄扩权。一次连接覆盖当前身份已有的方案、发单、接单及交付能力,无需分别配置。既有只读连接先复用,需要新权限时另行由用户重新授权。
45
+ ## 复用连接,再检查
42
46
 
43
- 登录及授权由用户本人完成,凭据交给宿主保存。不要索取密码、Cookie、Token,不读取其他浏览器登录态,不把授权链接、回调参数写入文件或日志。配置文件不含静态凭据。尚未登录时可完成安装与配置,报告“等待登录授权”。
47
+ Skill 安装与 MCP 连接分开判断。同站点连接已经可用时直接复用,不因更新 Skill 删除、重建连接或要求重新授权。Qveris 中“已保存”不等于当前会话已启用;只检查一次是否启用并刷新,不反复用全局研究工具搜索。界面显示“任务工具离线”不能单独证明 OpRun MCP 不可用。
44
48
 
45
- ## 检查和恢复
49
+ 没有连接时,使用宿主原生方式导入对应配置;仅查看时使用只读配置。需要增加权限时再由用户重新授权,不悄悄扩大已有授权。用户本人完成首次 OAuth;密码、Cookie、Token、授权回调参数都不应索取、导出或保存到日志。
46
50
 
47
- | 检查结果 | 下一步 |
51
+ | 客户端 | 新建连接时使用 |
48
52
  | --- | --- |
49
- | Skill 已安装,宿主未发现 | 按宿主要求重新加载会话 |
50
- | 公开发现失败 | 检查网络和站点;不能报告已连接或已是最新 |
51
- | 尚未授权、401 | 使用已有连接的登录授权入口 |
52
- | 工具未加载 | 检查连接是否启用并刷新;不查询业务数据 |
53
- | 权限不足 | 根据 account_context 的 required_scopes,在需要该功能时重新授权 |
54
- | 本地 Skill 有改动 | 保留并核对差异,不使用强制覆盖 |
55
- | 旧版非托管安装 | 内容与正式包一致时登记版本;不同则先备份、比较,由用户决定保留方式 |
53
+ | Codex / Claude Code | 宿主支持的 MCP OAuth 方式,命令以本机帮助为准 |
54
+ | Qveris | [统一配置](skills/oprun-project-planning/assets/qveris-mcp.json)或[只读配置](skills/oprun-project-planning/assets/qveris-readonly-mcp.json),点击“保存并授权” |
55
+ | WorkBuddy | [专用配置](skills/oprun-project-planning/assets/workbuddy-mcp.json),点击“连接” |
56
+ | 其他 | 核实支持 Streamable HTTP 和 OAuth S256 PKCE,使用原生连接入口 |
57
+
58
+ 服务地址和 OAuth issuer 均为 `https://www.agi.yifx.vip/mcp`。Qveris 显式使用 `authMode: oauth`、该 issuer 及配置中的 Scope,不填写 `openid offline_access`。详细差异按需阅读 [Qveris 指引](skills/oprun-project-planning/references/qveris.md)、[WorkBuddy 指引](skills/oprun-project-planning/references/workbuddy.md)及[多宿主指引](skills/oprun-project-planning/references/hosts.md)。一个连接覆盖当前身份获准的方案、发单、接单、交付等能力,无需分别配置。
59
+
60
+ 有命令工具时可运行 `doctor` 检查本地记录和公开 OAuth 发现;`--offline` 只核对文件。没有命令工具时跳过 doctor,直接用当前宿主检查连接和工具加载,再调用 `oprun_account_context`;支持直接 `tools/list` 时一并检查。不得为了验证安装而读取项目、生成方案或执行业务操作。
61
+
62
+ 公开发现通过不等于 OAuth 成功。无法调用 MCP 时报告“连接待验证”,不因导入 Skill 或用户已登录就宣称工具可用。`update_available` 只表示本地版本早于 CLI 所携版本;`host_managed` 只表示安装由客户端管理,不是已安装证明。
63
+
64
+ ## 完成状态与恢复
65
+
66
+ 分别报告 Skill 和连接状态,保持简短:例如“Skill 已导入;连接已验证”,或“等待 ZIP 导入;已有连接保留”。只有客户端证据或用户确认支持时才报告已导入,只有实际工具调用成功时才报告连接已验证;版本、摘要未核实的部分单独说明。
67
+
68
+ | 情况 | 下一步 |
69
+ | --- | --- |
70
+ | Skill 已导入,当前会话未启用 | 选择 Skill,或按宿主要求重新加载会话 |
71
+ | 401 / 授权已失效 | 使用现有连接的登录授权入口 |
72
+ | 工具未加载 | 检查连接启用状态并刷新一次 |
73
+ | 权限不足 | 根据 account_context 的 required_scopes,在使用该功能时重新授权 |
74
+ | 本地内容有改动 | 保留并核对差异,不强制覆盖 |
75
+ | 无法核实版本或调用工具 | 如实标为待核实,不重复安装来代替验证 |
76
+
77
+ npm 更新输出 backup 路径,备份位于 Skill 扫描目录外的 `oprun-skill-backups`。恢复前核对两边安装记录和摘要,先保存当前内容,再将 backup 中完整 Skill 目录放回原 target,不能覆盖后续本地修改。ZIP 导入前保存的原包和自定义内容也应保留。撤销授权使用[授权管理](https://www.agi.yifx.vip/mcp/manage),安装更新不会自动撤销。
56
78
 
57
- 安装与更新验证只需 `tools/list` 和 `oprun_account_context`。不自动列出项目、生成方案或执行业务操作。用户已有具体任务时,连接通过后再继续原任务。撤销入口:[授权管理](https://www.agi.yifx.vip/mcp/manage)。
79
+ 说明页面读取失败时改用 GitHub Contents API 的 INSTALL.md(content 为 Base64);不要重复读取被当作 `application/octet-stream` 的 Release 说明附件。只提供官方链接时如实标记未读取版本。
58
80
 
59
- Skill 正文仍由 oprun-mcp 固定来源同步。本次安装器更新不改变服务器能力,文件内容一致时版本登记可更新,无需反复重新登录。新权限和客户端真实展示验收分别确认,不把脚本校验当成真实客户端验收。
81
+ Skill 正文唯一来源仍是 oprun-mcp 的固定提交。安装指引更新不改变服务端能力,不代替客户端真实验收。
package/README.md CHANGED
@@ -2,7 +2,9 @@
2
2
 
3
3
  安装或更新,把这句话发给你的 Agent:
4
4
 
5
- > 请按 https://github.com/TeamSillyBees/oprun-skills/blob/main/INSTALL.md 安装或更新 OpRun,带我完成连接。
5
+ > 请按 https://github.com/TeamSillyBees/oprun-skills/blob/main/INSTALL.md 安装或更新 OpRun,根据当前客户端能力选择命令安装或 ZIP 导入,保留已有配置,并检查连接。
6
+
7
+ Agent 会先检查当前会话能力:能执行命令且已有 Node.js 22+ 时使用 npm/npx;否则直接给出 ZIP 下载链接和客户端导入步骤,不要求安装开发环境。更新复用已有 MCP 连接;需要手动导入时明确提示“等待导入确认”。
6
8
 
7
9
  有 Node.js 22+ 的命令行客户端可直接运行:
8
10
 
package/bundle.json CHANGED
@@ -1,12 +1,12 @@
1
1
  {
2
- "version": "1.4.0",
2
+ "version": "1.4.1",
3
3
  "repository": "TeamSillyBees/oprun-skills",
4
4
  "skill": "oprun-project-planning",
5
5
  "grant_version": 2,
6
6
  "mcp_revision": "7a2f5da2b1f96e18e224fa428873a0407dc2589b",
7
7
  "source_repository": "TeamSillyBees/oprun-mcp",
8
8
  "source_merge_status": "merged",
9
- "revision": "82c868868f75f99c86b10b5164059de3002348bc",
9
+ "revision": "76baadfd72ee254713bab68b27d6af678661d3d3",
10
10
  "skill_files": {
11
11
  "SKILL.md": "4ebf243ef59a5407506e470f87cbb23e115b18b8a62262d13508af4896608f99",
12
12
  "assets/external-plan.example.json": "02b2b875d6f7220a30406ac4e8ad896787fed03e0ab751bd3b69383e210079b2",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "oprun-skills",
3
- "version": "1.4.0",
3
+ "version": "1.4.1",
4
4
  "description": "Install, update and check the official OpRun Skill and remote MCP connection guidance",
5
5
  "type": "module",
6
6
  "bin": {
@@ -33,7 +33,7 @@
33
33
  "test": "node --test tests/*.test.mjs"
34
34
  },
35
35
  "oprun": {
36
- "source_revision": "82c868868f75f99c86b10b5164059de3002348bc",
36
+ "source_revision": "76baadfd72ee254713bab68b27d6af678661d3d3",
37
37
  "mcp_revision": "7a2f5da2b1f96e18e224fa428873a0407dc2589b"
38
38
  }
39
39
  }
package/release.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.4.0",
2
+ "version": "1.4.1",
3
3
  "repository": "TeamSillyBees/oprun-skills",
4
4
  "skill": "oprun-project-planning",
5
5
  "grant_version": 2,