@inf-monkeys-tech/monkeys-cli 0.11.1 → 0.11.3
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/README.md +50 -21
- package/README.zh.md +27 -19
- package/bin/install-wizard.js +12 -2
- package/bin/run.js +4 -4
- package/dist/command/metadata.d.ts +11 -0
- package/dist/command/metadata.d.ts.map +1 -0
- package/dist/command/metadata.js +150 -0
- package/dist/command/metadata.js.map +1 -0
- package/dist/commands/agent/work/watch.d.ts +3 -2
- package/dist/commands/agent/work/watch.d.ts.map +1 -1
- package/dist/commands/agent/work/watch.js +10 -5
- package/dist/commands/agent/work/watch.js.map +1 -1
- package/dist/commands/context/show.d.ts +11 -0
- package/dist/commands/context/show.d.ts.map +1 -0
- package/dist/commands/context/show.js +32 -0
- package/dist/commands/context/show.js.map +1 -0
- package/dist/commands/execution/watch.d.ts +3 -2
- package/dist/commands/execution/watch.d.ts.map +1 -1
- package/dist/commands/execution/watch.js +10 -5
- package/dist/commands/execution/watch.js.map +1 -1
- package/dist/commands/identity/get.d.ts +13 -0
- package/dist/commands/identity/get.d.ts.map +1 -0
- package/dist/commands/identity/get.js +18 -0
- package/dist/commands/identity/get.js.map +1 -0
- package/dist/commands/identity/list.d.ts +17 -0
- package/dist/commands/identity/list.d.ts.map +1 -0
- package/dist/commands/identity/list.js +33 -0
- package/dist/commands/identity/list.js.map +1 -0
- package/dist/commands/schema.d.ts +17 -0
- package/dist/commands/schema.d.ts.map +1 -0
- package/dist/commands/schema.js +56 -0
- package/dist/commands/schema.js.map +1 -0
- package/dist/commands/skills/list.d.ts +9 -0
- package/dist/commands/skills/list.d.ts.map +1 -0
- package/dist/commands/skills/list.js +11 -0
- package/dist/commands/skills/list.js.map +1 -0
- package/dist/commands/skills/read.d.ts +14 -0
- package/dist/commands/skills/read.d.ts.map +1 -0
- package/dist/commands/skills/read.js +20 -0
- package/dist/commands/skills/read.js.map +1 -0
- package/dist/commands/skills/status.d.ts +9 -0
- package/dist/commands/skills/status.d.ts.map +1 -0
- package/dist/commands/skills/status.js +12 -0
- package/dist/commands/skills/status.js.map +1 -0
- package/dist/commands/skills/sync.d.ts +10 -0
- package/dist/commands/skills/sync.d.ts.map +1 -0
- package/dist/commands/skills/sync.js +36 -0
- package/dist/commands/skills/sync.js.map +1 -0
- package/dist/commands/team/get.d.ts +13 -0
- package/dist/commands/team/get.d.ts.map +1 -0
- package/dist/commands/team/get.js +18 -0
- package/dist/commands/team/get.js.map +1 -0
- package/dist/commands/team/list.d.ts +16 -0
- package/dist/commands/team/list.d.ts.map +1 -0
- package/dist/commands/team/list.js +31 -0
- package/dist/commands/team/list.js.map +1 -0
- package/dist/commands/update.d.ts +2 -4
- package/dist/commands/update.d.ts.map +1 -1
- package/dist/commands/update.js +37 -76
- package/dist/commands/update.js.map +1 -1
- package/dist/commands/version/check.d.ts.map +1 -1
- package/dist/commands/version/check.js +8 -4
- package/dist/commands/version/check.js.map +1 -1
- package/dist/commands/version/show.d.ts +2 -2
- package/dist/commands/version/show.d.ts.map +1 -1
- package/dist/commands/version/show.js +7 -12
- package/dist/commands/version/show.js.map +1 -1
- package/dist/config/environment-profile.d.ts +5 -0
- package/dist/config/environment-profile.d.ts.map +1 -0
- package/dist/config/environment-profile.js +47 -0
- package/dist/config/environment-profile.js.map +1 -0
- package/dist/config/local-command.d.ts +9 -1
- package/dist/config/local-command.d.ts.map +1 -1
- package/dist/config/local-command.js +44 -5
- package/dist/config/local-command.js.map +1 -1
- package/dist/config/store.d.ts +3 -0
- package/dist/config/store.d.ts.map +1 -1
- package/dist/config/store.js +15 -1
- package/dist/config/store.js.map +1 -1
- package/dist/contracts/version.d.ts +1 -1
- package/dist/contracts/version.d.ts.map +1 -1
- package/dist/contracts/version.js +9 -1
- package/dist/contracts/version.js.map +1 -1
- package/dist/discovery/client.d.ts +31 -0
- package/dist/discovery/client.d.ts.map +1 -0
- package/dist/discovery/client.js +117 -0
- package/dist/discovery/client.js.map +1 -0
- package/dist/discovery/pagination.d.ts +20 -0
- package/dist/discovery/pagination.d.ts.map +1 -0
- package/dist/discovery/pagination.js +32 -0
- package/dist/discovery/pagination.js.map +1 -0
- package/dist/output/render.d.ts +7 -1
- package/dist/output/render.d.ts.map +1 -1
- package/dist/output/render.js +73 -0
- package/dist/output/render.js.map +1 -1
- package/dist/schema/command-schema.d.ts +26 -0
- package/dist/schema/command-schema.d.ts.map +1 -0
- package/dist/schema/command-schema.js +27 -0
- package/dist/schema/command-schema.js.map +1 -0
- package/dist/skills/content.d.ts +13 -0
- package/dist/skills/content.d.ts.map +1 -0
- package/dist/skills/content.js +103 -0
- package/dist/skills/content.js.map +1 -0
- package/dist/skills/state.d.ts +43 -0
- package/dist/skills/state.d.ts.map +1 -0
- package/dist/skills/state.js +56 -0
- package/dist/skills/state.js.map +1 -0
- package/dist/skills/sync.d.ts +28 -0
- package/dist/skills/sync.d.ts.map +1 -0
- package/dist/skills/sync.js +17 -0
- package/dist/skills/sync.js.map +1 -0
- package/dist/update/updater.d.ts +1 -0
- package/dist/update/updater.d.ts.map +1 -1
- package/dist/update/updater.js +21 -5
- package/dist/update/updater.js.map +1 -1
- package/oclif.manifest.json +5967 -324
- package/package.json +57 -3
- package/skills/monkeys-agent-work/SKILL.md +21 -0
- package/skills/monkeys-agent-work/agents/openai.yaml +4 -0
- package/skills/monkeys-auth/SKILL.md +21 -0
- package/skills/monkeys-auth/agents/openai.yaml +4 -0
- package/skills/monkeys-data/SKILL.md +31 -0
- package/skills/monkeys-data/agents/openai.yaml +4 -0
- package/skills/monkeys-openapi/SKILL.md +19 -0
- package/skills/monkeys-openapi/agents/openai.yaml +4 -0
- package/skills/monkeys-shared/SKILL.md +31 -0
- package/skills/monkeys-shared/agents/openai.yaml +4 -0
- package/skills/{monkeys → monkeys-shared}/references/compatibility.md +1 -1
- package/skills/monkeys-system-config/SKILL.md +20 -0
- package/skills/monkeys-system-config/agents/openai.yaml +4 -0
- package/skills/monkeys-workflow/SKILL.md +21 -0
- package/skills/monkeys-workflow/agents/openai.yaml +4 -0
- package/skills/monkeys/SKILL.md +0 -60
- package/skills/monkeys/agents/openai.yaml +0 -4
- /package/skills/{monkeys → monkeys-agent-work}/references/agent-work.md +0 -0
- /package/skills/{monkeys → monkeys-auth}/references/authentication.md +0 -0
- /package/skills/{monkeys → monkeys-data}/references/data-governance.md +0 -0
- /package/skills/{monkeys → monkeys-data}/references/data-perspective.md +0 -0
- /package/skills/{monkeys → monkeys-data}/references/data-read.md +0 -0
- /package/skills/{monkeys → monkeys-data}/references/data-transfer.md +0 -0
- /package/skills/{monkeys → monkeys-data}/references/data-write.md +0 -0
- /package/skills/{monkeys → monkeys-data}/references/ontology-feature-search.md +0 -0
- /package/skills/{monkeys → monkeys-data}/references/ontology-model.md +0 -0
- /package/skills/{monkeys → monkeys-openapi}/references/fallback.md +0 -0
- /package/skills/{monkeys → monkeys-shared}/references/platform-overview.md +0 -0
- /package/skills/{monkeys → monkeys-shared}/references/safety-errors.md +0 -0
- /package/skills/{monkeys → monkeys-system-config}/references/system-config.md +0 -0
- /package/skills/{monkeys → monkeys-workflow}/references/workflow-execution-files.md +0 -0
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@inf-monkeys-tech/monkeys-cli",
|
|
3
|
-
"version": "0.11.
|
|
3
|
+
"version": "0.11.3",
|
|
4
4
|
"packageManager": "bun@1.3.14",
|
|
5
5
|
"description": "Monkeys command-line client for AI agents, automation, and interactive use",
|
|
6
6
|
"type": "module",
|
|
@@ -33,7 +33,7 @@
|
|
|
33
33
|
"format:check": "prettier --check package.json tsconfig.json tsconfig.build.json .prettierrc.json bin scripts src test",
|
|
34
34
|
"language:check": "node ./scripts/check-english.mjs",
|
|
35
35
|
"lint": "tsc -p tsconfig.json --noEmit",
|
|
36
|
-
"pack:standalone": "bun run build && oclif
|
|
36
|
+
"pack:standalone": "bun run build && node ./scripts/oclif-pack.mjs -t win32-x64,linux-x64,darwin-x64",
|
|
37
37
|
"prepack": "bun run clean && bun run build",
|
|
38
38
|
"smoke:installer": "node ./scripts/install-wizard-smoke.mjs",
|
|
39
39
|
"smoke:npm": "node ./scripts/npm-install-smoke.mjs",
|
|
@@ -49,6 +49,59 @@
|
|
|
49
49
|
"dirname": "monkeys",
|
|
50
50
|
"commands": "./dist/commands",
|
|
51
51
|
"topicSeparator": " ",
|
|
52
|
+
"topics": {
|
|
53
|
+
"agent": {
|
|
54
|
+
"description": "Manage Agent Work and collaborative agent operations"
|
|
55
|
+
},
|
|
56
|
+
"api": {
|
|
57
|
+
"description": "Discover and call Platform OpenAPI operations"
|
|
58
|
+
},
|
|
59
|
+
"auth": {
|
|
60
|
+
"description": "Sign in, inspect credentials, and manage authentication"
|
|
61
|
+
},
|
|
62
|
+
"config": {
|
|
63
|
+
"description": "Inspect and change tenant system configuration"
|
|
64
|
+
},
|
|
65
|
+
"context": {
|
|
66
|
+
"description": "Inspect the resolved Profile, Team, tenant, and endpoint context"
|
|
67
|
+
},
|
|
68
|
+
"data": {
|
|
69
|
+
"description": "Manage ontology, assets, values, views, tags, and transfers"
|
|
70
|
+
},
|
|
71
|
+
"deployment": {
|
|
72
|
+
"description": "Manage local deployment endpoint definitions"
|
|
73
|
+
},
|
|
74
|
+
"execution": {
|
|
75
|
+
"description": "Inspect and monitor workflow executions"
|
|
76
|
+
},
|
|
77
|
+
"file": {
|
|
78
|
+
"description": "Upload and download platform files"
|
|
79
|
+
},
|
|
80
|
+
"identity": {
|
|
81
|
+
"description": "Discover users and Agent identities"
|
|
82
|
+
},
|
|
83
|
+
"post-review": {
|
|
84
|
+
"description": "Inspect workflow post-review audit jobs"
|
|
85
|
+
},
|
|
86
|
+
"profile": {
|
|
87
|
+
"description": "Manage endpoint subscriptions and active Profile selection"
|
|
88
|
+
},
|
|
89
|
+
"skills": {
|
|
90
|
+
"description": "List, read, verify, and synchronize bundled Agent Skills"
|
|
91
|
+
},
|
|
92
|
+
"team": {
|
|
93
|
+
"description": "Discover Teams available to the current identity"
|
|
94
|
+
},
|
|
95
|
+
"update": {
|
|
96
|
+
"description": "Update the CLI and synchronize bundled Agent Skills"
|
|
97
|
+
},
|
|
98
|
+
"version": {
|
|
99
|
+
"description": "Inspect CLI and compatibility versions"
|
|
100
|
+
},
|
|
101
|
+
"workflow": {
|
|
102
|
+
"description": "Create, inspect, run, and transfer workflows"
|
|
103
|
+
}
|
|
104
|
+
},
|
|
52
105
|
"update": {
|
|
53
106
|
"node": {
|
|
54
107
|
"version": "24.18.0"
|
|
@@ -61,6 +114,7 @@
|
|
|
61
114
|
"csv-parse": "6.1.0",
|
|
62
115
|
"csv-stringify": "6.6.0",
|
|
63
116
|
"exceljs": "4.4.0",
|
|
117
|
+
"jq-wasm": "3.0.0-jq-1.8.2",
|
|
64
118
|
"saxes": "5.0.1",
|
|
65
119
|
"undici": "7.29.0",
|
|
66
120
|
"unzipper": "0.10.14",
|
|
@@ -88,5 +142,5 @@
|
|
|
88
142
|
"publishConfig": {
|
|
89
143
|
"access": "public"
|
|
90
144
|
},
|
|
91
|
-
"monkeysReleaseCommit": "
|
|
145
|
+
"monkeysReleaseCommit": "ab0d1e2a50204a95819c7f1624806374c14ca2f9"
|
|
92
146
|
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: monkeys-agent-work
|
|
3
|
+
description: 通过 monkeys CLI 管理 Kernel Agent Work 的查询、创建、分配、对话、暂停、恢复、重试、Spec 审批、Review 验收与观察。用户提到 Agent Console、工作单、运行时分配、用户输入、审批、验收或协作者时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Monkeys Agent Work
|
|
7
|
+
|
|
8
|
+
先运行 `monkeys skills read monkeys-shared`,再读取[Agent Work](references/agent-work.md)。
|
|
9
|
+
|
|
10
|
+
## 执行原则
|
|
11
|
+
|
|
12
|
+
1. 只使用预期 Surface 为 Kernel 的 Profile;运行 `monkeys context show` 确认 `authSurface=kernel`。
|
|
13
|
+
2. 用 `monkeys schema agent work <action>` 获取当前命令合同;创建或变更前精确查询 Work ID 与最新 Revision。
|
|
14
|
+
3. 写操作先 `--dry-run`;分配新 Runtime、重试、Spec 审批与 Review 验收等特权操作需要用户确认后再传 `--yes`。
|
|
15
|
+
4. 观察时明确区分服务端状态与本地轮询;Ctrl+C 只停止本地观察。
|
|
16
|
+
|
|
17
|
+
## 必须升级给用户的状态
|
|
18
|
+
|
|
19
|
+
`user_input_required`、`spec_approval_required`、`pending_review`、`pending_acceptance`、`blocked`、失败或超时必须在聊天中明确说明。`MUTATION_OUTCOME_UNKNOWN` 时只做只读恢复检查。
|
|
20
|
+
|
|
21
|
+
Agent Work 固定 `teamMode=none`,不得传入或继承 Team,也不得在权限不足时静默切换 Studio。
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: monkeys-auth
|
|
3
|
+
description: 通过 monkeys CLI 安全配置订阅并使用浏览器 Device Code 或 API Key 登录,检查当前身份、认证存储与 Profile。用户要登录、退出、导入 API Key、切换 endpoint/订阅、诊断认证或查询 whoami 时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Monkeys Auth
|
|
7
|
+
|
|
8
|
+
开始前先运行 `monkeys skills read monkeys-shared`,遵循公共 Context、安全、输出和版本规则;再读取[认证与上下文](references/authentication.md)。
|
|
9
|
+
|
|
10
|
+
## 登录路径
|
|
11
|
+
|
|
12
|
+
- 浏览器登录:用 `monkeys auth login --url <Endpoint> --no-wait` 获取服务端 `verification_url`,原样交给用户;用户确认完成后,用同一次响应的临时 Profile 与 Device Code 继续轮询。
|
|
13
|
+
- API Key 登录:Key 只允许通过 `--api-key-stdin` 或 `--api-key-env` 输入,禁止出现在参数、文件、聊天或日志中。
|
|
14
|
+
- 登录后用服务端返回的已认证 `tenantId` 作为订阅/Profile 名;不得从 URL 主机名猜名称。
|
|
15
|
+
- 用 `monkeys auth whoami --profile <Profile>` 或 `monkeys auth status --profile <Profile>` 验证身份与 Surface。
|
|
16
|
+
|
|
17
|
+
## 安全边界
|
|
18
|
+
|
|
19
|
+
- CLI 和 Agent 都不得处理账户密码,不得自行填写浏览器登录表单。
|
|
20
|
+
- Device Code 只能用于原始 Endpoint 与临时 Profile,不得跨订阅复用。
|
|
21
|
+
- Keyring 或安全存储不可用时停止,不得降级为普通明文文件。
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: monkeys-data
|
|
3
|
+
description: 通过 monkeys CLI 理解并操作 Ontology、View、Asset、Field/Feature Value、Tag、Membership、Container 与 Data 导入导出。用户提到数据仓库、数据集、视图、增强视图、标签、字段、记录、筛选、媒体、附件、治理或迁移时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Monkeys Data
|
|
7
|
+
|
|
8
|
+
先运行 `monkeys skills read monkeys-shared`,遵循公共 Context、安全、输出与版本规则。
|
|
9
|
+
|
|
10
|
+
## 路由与模型
|
|
11
|
+
|
|
12
|
+
1. 任何 Data 操作先读取[Data 视角路由](references/data-perspective.md);概念不明确时读取[Ontology 领域模型](references/ontology-model.md)。
|
|
13
|
+
2. 用户未指定 Studio/Kernel 时省略 `--perspective`,由 CLI Studio-first;以 `perspectiveResolution`、`effectivePerspective`、`teamMode` 与 `resourceLocator` 为真相。
|
|
14
|
+
3. Kernel 全局读取默认不传 `--team`;数据资源定位只传已确认的 `--resource-team`。Team `0` 是共享/系统数据分区,不是所有 Team。
|
|
15
|
+
4. 首次执行命令先用 `monkeys schema data <domain> <action>` 获取当前参数、风险与 dry-run 合同。
|
|
16
|
+
|
|
17
|
+
## 按需读取
|
|
18
|
+
|
|
19
|
+
- 查询、搜索、抽样、媒体与附件:[Data 读取](references/data-read.md)
|
|
20
|
+
- 按 Feature Column 结构化值检索:[Ontology Feature 结构化检索](references/ontology-feature-search.md)
|
|
21
|
+
- 创建和修改资源:[Data 写入](references/data-write.md)
|
|
22
|
+
- Ontology、Container、Trash 与转换:[Data 初步治理](references/data-governance.md)
|
|
23
|
+
- JSONL、CSV、XLSX 与 Ontology 迁移:[Data 导入导出](references/data-transfer.md)
|
|
24
|
+
|
|
25
|
+
## 边界
|
|
26
|
+
|
|
27
|
+
- 新 Data 能力优先使用 Ontology;Bucket 只用于旧合同兼容。
|
|
28
|
+
- 不执行永久 Purge,不把 Container Membership remove 描述为删除 Asset。
|
|
29
|
+
- 筛选失败或空集合不得触发 View 转换、Raw API、PG 扫描或视角写重放。
|
|
30
|
+
- Data 文件未指定文件格式时按 JSONL;真实导入必须先对同一输入完成全量 dry-run,并获得精确 Profile、Perspective、Ontology 与文件授权。
|
|
31
|
+
- Asset/附件 URL 只在 CLI 内部使用;不得显示、签名或经普通 HTTP 工具处理。
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: monkeys-openapi
|
|
3
|
+
description: 通过 monkeys CLI 的 schema 与 api list/describe/call 探索已发布 OpenAPI,并在语义命令明确返回 fallbackEligible 时执行受控降级。用户需要查看服务端 operation schema、处理绑定漂移或语义命令暂未覆盖的已发布能力时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Monkeys OpenAPI
|
|
7
|
+
|
|
8
|
+
先运行 `monkeys skills read monkeys-shared`,再读取[受控语义到 API 降级](references/fallback.md)。
|
|
9
|
+
|
|
10
|
+
## 执行流程
|
|
11
|
+
|
|
12
|
+
1. 优先使用语义命令和 `monkeys schema <command path>`;只有语义命令返回 `fallbackEligible=true` 时才考虑降级。
|
|
13
|
+
2. 用 `monkeys api list` 搜索已发布 operation,再用 `monkeys schema --operation-id <operationId>` 或 `monkeys api describe` 核对 method、path、参数、权限、风险与 idempotency。
|
|
14
|
+
3. 写操作先用 `api call --dry-run`,回显 Profile、Team、operationId 与精确目标;需要确认的风险得到用户授权后才传 `--yes`。
|
|
15
|
+
4. 只使用 CLI 返回的同一 Context、短期 Evidence;不得自行拼 URL、Header 或直接发送 HTTP。
|
|
16
|
+
|
|
17
|
+
## 禁止降级
|
|
18
|
+
|
|
19
|
+
认证、授权、确认、输入错误、Workflow 写操作,以及请求已 `sent` 或 `result_unknown` 时禁止降级或重放。OpenAPI 不可用、过期或未发布时停止并报告恢复建议。
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: monkeys-shared
|
|
3
|
+
description: 通过 monkeys CLI 选择多租户或私有化部署的 Profile、Context、Team 与 Identity,并遵循统一的输出、风险、错误、安全和 CLI/Skill 版本规则。用户询问 Monkeys 平台能力、订阅上下文、命令参数、结构化错误、版本兼容或其他 monkeys-* Skill 需要公共规则时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Monkeys Shared
|
|
7
|
+
|
|
8
|
+
只通过 `monkeys` CLI 操作平台。不要直接发送 HTTP 请求,也不要把 Tool、Workflow 或 Plugin capability 当作平台 API。
|
|
9
|
+
|
|
10
|
+
## 公共执行流程
|
|
11
|
+
|
|
12
|
+
1. 运行 `monkeys version show`;若 `_notice.update` 存在,只报告升级提示,得到用户授权后才运行 `monkeys update`。
|
|
13
|
+
2. 运行 `monkeys context show --profile <Profile>` 核对 endpoint、tenant、credential kind、Surface 与 Team。Profile 不明确时先用 `monkeys profile list`,Team 或 Identity 不明确时用 `monkeys team list`、`monkeys identity list`,禁止猜测。
|
|
14
|
+
3. 第一次使用命令或参数不确定时运行 `monkeys schema <command path>`;领域导航不明确时运行 `monkeys --help`。
|
|
15
|
+
4. 默认消费 JSON envelope:成功读取 `.data`,失败读取 `.error`,系统提示读取 `._notice`。需要窄字段时使用 `--jq`;面向人展示时才用 `--format table|text`。
|
|
16
|
+
5. 写操作先运行 `--dry-run`,回显精确 Profile、Team、目标 ID 与风险。只有 schema 标记需要确认时才传 `--yes`,不得自动重放结果未知的写请求。
|
|
17
|
+
6. 返回结果、关键资源 ID 与 Context Fingerprint;失败时返回 error code、recovery、retryable 和副作用是否未知。
|
|
18
|
+
|
|
19
|
+
## 按需读取
|
|
20
|
+
|
|
21
|
+
- 平台领域与命令入口:[平台能力地图](references/platform-overview.md)
|
|
22
|
+
- Secret、确认、批处理与结构化错误:[安全与错误](references/safety-errors.md)
|
|
23
|
+
- CLI/Skills 同版本合同:[兼容性](references/compatibility.md)
|
|
24
|
+
|
|
25
|
+
## 不可违反的边界
|
|
26
|
+
|
|
27
|
+
- 不索要、接收、显示或落盘密码、API Key、Bearer Token、Session Token 或签名 URL。
|
|
28
|
+
- 不覆盖认证、Tenant、Team 与 Data Perspective 等受保护 Header。
|
|
29
|
+
- 不把可读、Public 或 Shared 理解为可写;服务端授权是最终判断。
|
|
30
|
+
- 不从 URL、页面标题、相似名称、Owner Team 或 Session Team 猜 Tenant、Team、Identity 或资源位置。
|
|
31
|
+
- 不自动重放已发送、超时或结果未知的写操作;只做只读恢复检查。
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
- 本 Skill 面向命令 Schema Major `2`,最低 CLI 版本 `0.11.0`。
|
|
4
4
|
- 开始任务时运行 `monkeys version show --output json`。
|
|
5
5
|
- 任意结构化输出中的 `_notice.update` 表示 npm `latest` 高于当前 CLI;报告 `current`、`latest` 与 `command`。可用 `monkeys update --check --output json` 实时复核,只有用户明确授权后才运行 `monkeys update` 或 `monkeys update --force`。
|
|
6
|
-
- `monkeys update` 升级全局 npm
|
|
6
|
+
- `monkeys update` 升级全局 npm 包后,从新包的全局安装目录同步全部 7 个同版本 Skills,并写入版本与校验和状态;用 `monkeys skills status` 检查漂移,用 `monkeys skills sync` 只重同步 Skills。若 `skillsAction=failed`,报告警告,不回滚 CLI 或猜测 Skill 路径。
|
|
7
7
|
- CLI Major、命令 Schema Major 或 Skill 声明不兼容时停止写操作,升级匹配版本后再继续。
|
|
8
8
|
- OpenAPI Snapshot 可动态刷新,但语义命令合同不会因刷新而被静默改写。
|
|
9
9
|
- Data 合同由 Deployment 的 `data_contract=auto|ontology-v1|bucket-v1` 决定;`auto` 依次采用精确 OpenAPI、同一上下文缓存和有界只读探测。只有 Ontology 路由明确返回 404 时才探测旧 Bucket 路由。
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: monkeys-system-config
|
|
3
|
+
description: 通过 monkeys CLI 查看、校验、导出、历史查询并按 Key 窄修改 Kernel System Config。用户提到平台系统配置、配置 Key、环境配置、校验、历史版本或敏感配置值时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Monkeys System Config
|
|
7
|
+
|
|
8
|
+
先运行 `monkeys skills read monkeys-shared`,再读取[System Config](references/system-config.md)。
|
|
9
|
+
|
|
10
|
+
## 执行原则
|
|
11
|
+
|
|
12
|
+
1. 只使用 Kernel Profile;Team 仅是身份上下文,不是配置作用域。
|
|
13
|
+
2. 先运行 `monkeys config overview/list/get` 发现精确 Key,再用 `monkeys schema config <action>` 核对参数;禁止猜 Key。
|
|
14
|
+
3. 修改前运行同一命令的 `--dry-run`,回显环境、精确 Key、非敏感摘要与恢复路径。
|
|
15
|
+
4. 敏感值只通过 `config set --value-stdin` 输入;不得出现在参数、文件、日志或回答中。
|
|
16
|
+
|
|
17
|
+
## 边界
|
|
18
|
+
|
|
19
|
+
- 不提供或臆造 replace、import、rollback、unset/reset。
|
|
20
|
+
- `MUTATION_OUTCOME_UNKNOWN` 时禁止自动重试,只做 get/history 等只读恢复检查。
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: monkeys-workflow
|
|
3
|
+
description: 通过 monkeys CLI 查询、创建、更新、删除、导入、导出和运行 Workflow,查看或等待 Execution,并安全传输平台文件。用户提到工作流定义、执行记录、运行输入输出、等待状态、上传或下载文件时使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Monkeys Workflow
|
|
7
|
+
|
|
8
|
+
先运行 `monkeys skills read monkeys-shared`,再读取[Workflow、Execution 与文件](references/workflow-execution-files.md)。
|
|
9
|
+
|
|
10
|
+
## 执行原则
|
|
11
|
+
|
|
12
|
+
1. 用 `monkeys context show` 核对 Profile 与 Team;用 `monkeys schema workflow <action>` 获取当前参数合同。
|
|
13
|
+
2. 查询目标 Workflow 与版本后再写;写操作先 `--dry-run`,并回显实际 Team、Workflow ID、版本与输入文件。
|
|
14
|
+
3. 运行后返回 `workflowInstanceId`;需要结果时使用 `execution wait/watch/get`,不要把本地 Ctrl+C 误报为服务端取消。
|
|
15
|
+
4. 文件只用 `monkeys file upload/download`;不得把 URL 猜成对象 Key,也不得显示签名 URL。
|
|
16
|
+
|
|
17
|
+
## 边界
|
|
18
|
+
|
|
19
|
+
- Workflow 写操作不得使用 Raw API 降级,不使用 ETag;依赖 CLI 写前快照与写后回读恢复。
|
|
20
|
+
- 已发送或结果未知的写操作禁止自动重放。
|
|
21
|
+
- 以输出的 `contractVariant`、`teamMode`、`effectiveTeamId` 和 `ownerTeamId` 为事实,不补造缺失字段。
|
package/skills/monkeys/SKILL.md
DELETED
|
@@ -1,60 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: monkeys
|
|
3
|
-
description: 理解并通过 monkeys CLI 安全操作 Monkeys 平台的多租户/私有化部署、认证、Workflow、Execution、Agent Work、文件、Data/Ontology 与 Kernel System Config。用户询问平台能力、Ontology、View、增强视图、Asset、Field、Tag 等概念,要求管理平台资源,或 Agent 需要选择 Profile、处理结构化错误和执行受控 OpenAPI 降级时使用。
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Monkeys CLI
|
|
7
|
-
|
|
8
|
-
只通过 `monkeys` CLI 操作平台。不要直接发送 HTTP 请求,也不要把 Tool/Workflow 的 capability 声明当作平台 API。
|
|
9
|
-
|
|
10
|
-
## 执行流程
|
|
11
|
-
|
|
12
|
-
1. 运行 `monkeys version show --output json`,确认 CLI 可用和命令 Schema 兼容。若输出包含 `_notice.update`,向用户报告新版本和 `monkeys update`;只有用户明确同意升级后才执行该全局安装命令。
|
|
13
|
-
2. 选择明确的 `--profile`。Data 查询只有在用户明确指定 Studio/Kernel 时才传对应的 `--perspective`;用户未指定时省略该参数,由 CLI 根据认证 Session 执行 Studio-first,并只在确定性空集合/精确资源 404 时自动升级到 Kernel。Kernel 全局读取默认不传 `--team`;需要数据资源定位时传已确认的 `--resource-team`。Team `0` 是共享/系统数据分区,不是“所有 Team”。以 CLI 的 `perspectiveResolution` 为路由真相,不由 Skill 手工换视角重试。
|
|
14
|
-
3. 在第一次使用命令或参数不确定时运行 `monkeys <命令> --help`。以 CLI 帮助为参数真相,不凭记忆补参数。
|
|
15
|
-
4. 优先调用 Workflow、Execution、Agent Work、File、Data、System Config 等语义命令,并使用 `--output json`。解析结构化结果和退出码,不解析面向人的 Text 文案。
|
|
16
|
-
5. 写操作前向用户回显 Profile、`teamMode`、实际生效的 Team(若有)、Ontology、实际 Data 合同、Data Perspective、精确目标 ID 或 System Config Key。目标模糊时先查询,禁止猜测。
|
|
17
|
-
6. 只按[受控降级](references/fallback.md)处理语义兼容性故障;认证、授权、确认和输入错误不得降级。
|
|
18
|
-
7. 返回执行结果、关键资源 ID、Context Fingerprint;失败时返回错误 code、恢复建议和是否可能已产生副作用。
|
|
19
|
-
|
|
20
|
-
## 按需读取
|
|
21
|
-
|
|
22
|
-
- 解释平台有哪些功能、某项需求应进入哪个领域或当前 CLI 是否覆盖:必须读取[平台能力地图](references/platform-overview.md)。
|
|
23
|
-
- 涉及 Ontology、View、增强视图、Asset、Field、Feature Value、Tag、Membership 或筛选语义:必须读取[Ontology 领域模型](references/ontology-model.md)。
|
|
24
|
-
- 配置部署、切换租户、API Key 或账户登录:读取[认证与上下文](references/authentication.md)。
|
|
25
|
-
- 查询、创建、导入、更新、删除或运行 Workflow,等待 Execution 或传文件:读取[工作流、执行与文件](references/workflow-execution-files.md)。
|
|
26
|
-
- 查询、创建、分配、对话、审批、验收或观察 Agent Work:必须读取[Agent Work](references/agent-work.md)。
|
|
27
|
-
- 查询、搜索或抽样 Data:读取[Data 读取](references/data-read.md)。按 Feature Column 的结构化值搜索 Asset 时,还必须读取[Ontology Feature 结构化检索](references/ontology-feature-search.md)。
|
|
28
|
-
- 创建、修改或删除 Data 资源:读取[Data 写入](references/data-write.md)。
|
|
29
|
-
- 管理 Ontology、移动/复制 Container、回收或恢复:必须读取[Data 治理](references/data-governance.md)。
|
|
30
|
-
- 导入或导出 Ontology 结构、JSONL、CSV 或 XLSX 数据:必须读取[Data 导入导出](references/data-transfer.md)。
|
|
31
|
-
- 任何 Data 操作:必须读取[Data 视角路由](references/data-perspective.md)。
|
|
32
|
-
- 查看、校验、导出或按 Key 修改 Kernel System Config:必须读取[System Config](references/system-config.md)。
|
|
33
|
-
- 语义命令返回 `fallbackEligible=true`:必须读取[受控降级](references/fallback.md)。
|
|
34
|
-
- 处理错误、确认、批处理或 Secret:读取[安全与错误](references/safety-errors.md)。
|
|
35
|
-
- 检查 CLI/Skill 版本:读取[兼容性](references/compatibility.md)。
|
|
36
|
-
|
|
37
|
-
## 不可违反的边界
|
|
38
|
-
|
|
39
|
-
- 不主动索要、接收或在回答中复述密码、API Key、Bearer Token。账户认证只允许通过 `auth login` 返回的 Deployment 浏览器地址完成;CLI 和 Agent 都不得处理账户密码。
|
|
40
|
-
- 首次登录以订阅 `--url` 为唯一 Endpoint 输入,不要求预建 Deployment/Profile。API Key 只经 `--api-key-stdin` 或 `--api-key-env` 导入;浏览器登录只把服务端签发的 Session Token 写入系统 Keyring。
|
|
41
|
-
- Agent 必须使用 `auth login --url <Endpoint> --no-wait --output json` 发起浏览器登录,把原样授权 URL 交给用户,并在用户确认完成后用同一次返回的临时 `profile` 与 `--device-code` 完成轮询;不得自行填写网页登录表单或跨 Endpoint 复用 Device Code。
|
|
42
|
-
- 登录成功后必须以 `/api/configs` 返回的已认证 `tenantId` 作为订阅/Profile 名;不得从 URL 主机名猜租户名。
|
|
43
|
-
- 不覆盖认证、Tenant、Team、Data Perspective 等受保护 Header。
|
|
44
|
-
- 不把 Session 的 `currentTeamId` 或 CLI 返回的 `resourceLocator.teamId` 描述为 Kernel 全局查询作用域,也不为 Kernel 全局读取手工补 `--team`。不得用 Ontology owner Team 猜测 `--resource-team`,也不得把 `0` 当默认兜底;只有用户明确指定或权威资源元数据确认共享/系统分区时才使用 Team `0`。缺少已确认值时在聊天中告知并停止。
|
|
45
|
-
- 不把 Public/Shared/可读理解为可写;服务端授权是最终判断。
|
|
46
|
-
- 不执行 Ontology/Bucket Delete、Container Purge、批量 Trash 或语义层未提供的永久清理。
|
|
47
|
-
- 不把 `data container remove` 描述为删除 Asset;它只移除 Membership,可从 Trash 恢复。
|
|
48
|
-
- 不在聊天或普通 HTTP 工具中处理 Asset/附件 URL,也不自行生成对象存储签名;始终使用 CLI 下载命令。CLI 可匿名读取公开 HTTPS 对象,访问受限时必须改由 Server 返回签名 URL,任何 URL 都不得显示在聊天中。
|
|
49
|
-
- 不把 View Feature 中的 PDF/文件误当成 Asset 封面;使用 `data asset attachment download`,只展示本地文件结果和审计信息,不展示 Feature Value URL。
|
|
50
|
-
- 不把筛选失败当成 View 类型不正确,不得为了实现 Tag/Field 筛选而自动执行 Filter View 到 Container View 的转换。
|
|
51
|
-
- 不把 Feature 结构化检索描述为语义、向量、模糊或全文搜索;不使用 Feature 展示名、Field ID 或 ES path 代替 `config.fieldKey`,也不在 HTTP 400/503 后改用 Raw API、PG 扫描或其他静默兜底。
|
|
52
|
-
- 不自动重放已发送或结果未知的写操作。
|
|
53
|
-
- Workflow 写操作不得使用 Raw API 降级;Update 不使用 ETag,并依赖 CLI 写前快照与写后回读恢复。
|
|
54
|
-
- Data 文件未显式指定 `--format` 时始终按 JSONL 处理;不得根据扩展名猜测 CSV/XLSX。真实导入必须先完成全量预检,并要求用户对精确 Profile、Perspective、Ontology 和文件明确授权。
|
|
55
|
-
- Data 文件迁移使用 `data asset import/export`;需要 Server 后台原生 JSONL 任务时使用 `data asset import-jsonl`;只给已有 Asset 回填图片/文本 Feature 时优先使用 `data asset feature-backfill`。不要根据文件名或数据量在这些写路径间静默切换。`data asset enrich-jsonl` 只是已弃用兼容入口;若被显式调用,必须把结果中的替代命令以当前聊天界面可读方式告诉用户。
|
|
56
|
-
- 完整 Ontology 迁移必须区分 owner Team 与 data resource Team:结构命令显式传 `--team` 和需要时的 `--resource-team`;Kernel Asset Export 用 `--resource-team` 定位读取资源,Asset Import 等写命令仍用 `--team` 指定目标数据 Team。包含 Field、Tag 或 View 引用的 Asset 导入必须传同一次真实 Ontology 导入生成的 `--ontology-report`,并在聊天中说明目标视角与 Team;不得用同名匹配或来源 ID 猜测。
|
|
57
|
-
- System Config 只允许 Kernel Profile;Team 仅是身份上下文,不是配置作用域。敏感 Key 只允许通过 `config set --value-stdin` 写入。
|
|
58
|
-
- Agent Work 只允许 Kernel Profile,固定 `teamMode=none`,不得传入或继承 Team,也不得在权限不足时静默改用 Studio。
|
|
59
|
-
- Agent Work 出现 `user_input_required`、`spec_approval_required`、`pending_review`、`pending_acceptance`、`blocked`、失败或超时时,必须在聊天中明确告诉用户;`MUTATION_OUTCOME_UNKNOWN` 时只做只读恢复检查。
|
|
60
|
-
- Agent Work 的聊天反馈必须面向人的任务与决策,并按当前 Agent 和聊天界面的可靠显示能力自适应呈现;不得把某个 Profile、租户或 Markdown 组件写成固定前提,也不得默认倾倒原始 JSON。
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|