Repository navigation
Commit 1120389
docs(skills): os package install takes -u/--url and -t/--token in the platform skill's operations reference (#30821)
<!-- claude-projects-attribution: {"github_login":"os-elon-musk"} -->
_Requested by **Elon** · [project
thread](https://claude.ai/code/project/chan_01WedDzV26nniwxv7jC88B9D?thread=cmsg_01WedDzV26nniwxv7jC88B9D7vtFzrHkwUNVapRbBcUPii)_
domain:skills#1 · os-elon-musk · session_016WV4czuE7FD4NhcJptgwre
Fixes #30772
Clause-②: no
Metadata-protocol: none
## 维护者速读
- **改了什么**:`objectstack-platform` 技能运维参考页里 `os package install`
那一行,服务器参数从 `--runtime` 改成 `-u/--url`,凭据补上新的 `-t/--token`(环境变量
`OS_RUNTIME_TOKEN`),与 `--email/--password` 并列。
- **为什么改**:PR #30792(#30126 第 13 行,裁决 A)已把 `-r/--runtime` 改名为 `-u/--url`
且不留别名,并新增 `-t/--token`;技能还写旧参数,AI 照抄会被 CLI 当作未知参数拒绝。
- **风险与回滚**:只改技能文案一行;删掉该行里与下方引用块重复的「via its install-local endpoint」来付
token 额度(3119/3119,未抬上限)。回滚即撤这个 PR。
- **先看**:`skills/objectstack-platform/references/operations.md` 第 106 行。
- **两分钟验证**:对照 `packages/cli/src/commands/package/install.ts` 的 `static
override flags`(`url` 为 `-u`、`OS_RUNTIME_URL`、默认
`http://localhost:3000`;`token` 为 `-t`、`OS_RUNTIME_TOKEN`),应与第 106 行一致。
- **需要你做的**:批准这个 Tier H PR(`skills/**` 需受管审批人 os-zhuang 或 hotlong
批准),之后席位落地。
## What changes
- `skills/objectstack-platform/references/operations.md` L106, the `os
package install` row: the synopsis now reads `[--version │ -u/--url
http://localhost:3000]` in place of `[--version │ --runtime
http://localhost:3000]`, and the credential sentence names `-t/--token`
beside `--email/--password`, with the env names `OS_RUNTIME_TOKEN` or
`OS_RUNTIME_EMAIL`/`OS_RUNTIME_PASSWORD`. "Auths with the target
runtime's session" becomes "Auths as a target runtime user", since a
token is not a session sign-in. The row keeps its shape and still says
the credential is not the cloud login.
- Same row: "via its install-local endpoint" is removed. The blockquote
under the table (L108-113) already says the cloud-connection plugins
"expose the install-local endpoint that `os package install` targets".
Removing the restatement pays for the token flag inside the ceiling.
- `.changeset/30772-platform-skill-package-install-url.md`:
`'@objectstack/skills': patch`.
## Why
Ruling A on #30126 row 13 (record 6674432613). PR #30792 landed it on
`main` at `2fbddd4c`, and this PR was merged with `origin/main`
`7da99b79` before the gates. On that tree,
`packages/cli/src/commands/package/install.ts` declares `url` (`char:
'u'`, `env: 'OS_RUNTIME_URL'`, default `http://localhost:3000`) and
`token` (`char: 't'`, `env: 'OS_RUNTIME_TOKEN'`). There is no `runtime`
flag left. `-v/--version` and `--email` / `--password`
(`OS_RUNTIME_EMAIL` / `OS_RUNTIME_PASSWORD`) are unchanged, and a token
together with `--email` / `--password` is refused.
`content/docs/deployment/cli.mdx` (L3261-3279) says the same.
## Tests
This PR changes skill prose only. No eval case names `os package
install` (`git grep 'package install' skills/` hits only L106 and the
blockquote's L112), so no eval was edited. No package code changed.
After the change, `git grep -- '--runtime'` over `skills/**` and
`.claude/**` returns nothing.
## Acceptance notes
- **Readings (skills/\*\*).** `operations.md`: 199 → 199 lines, 12475 →
12474 bytes, 3119 → 3119 tokens (ceiling 3119, headroom 0 → 0; no
ceiling raised). Bundle (sum of every `skills/*/SKILL.md`): unchanged at
4524 lines, since no SKILL.md is touched.
- **PR #30764** (open, Tier H) also edits `operations.md`, in other
hunks (L13, L42-58, a new section after L113, L192-193). This PR's
single hunk is L106 and does not overlap them. Whichever lands second
should re-run `check-skills-token-ratchet`. With #30764's −3 tokens, the
merged file still fits.
- The row does not say that `--runtime` was removed. The CLI refuses it
as an unknown flag, and the `@objectstack/cli` changeset from #30792
carries the FROM → TO migration.
## Verification
<details><summary>dispatch-gates on head b2d0f91: 43 derived, 43 run,
all exit 0; pnpm lint exit 0</summary>
`node scripts/pm/dispatch-gates.mjs --commands --repo
objectstack-ai/objectstack` derived 43 commands for the two changed
paths (merge base `7da99b79`). All 43 exited 0 on head `b2d0f914`, after
a whole-tree `pnpm build --concurrency=2` under `os-verify-lock` (118
tasks, VERDICT command-exit 0), which clears the five dist-reading
prerequisites (`check:doc-formula-expressions`, `check:dts-closure`,
`check:dual-build-cjs-loads`, `check:lean-entry-closure`,
`check:sourcemap-no-sources-content`). `check-skills-token-ratchet`:
`operations.md` 3119 / 3119.
`node scripts/pm/dispatch-gates.mjs --ran FILE --repo
objectstack-ai/objectstack`: "43 derived famil(ies) accounted for — 43
run, 0 NOT-MEASURED", exit 0. `pnpm lint`: exit 0.
```text
# head b2d0f91
node scripts/check-adr-0087-registration.mjs --base origin/main :: exit 0
node scripts/check-adr-0087-registration.mjs --self-test :: exit 0
node scripts/check-changeset-no-major.mjs --base origin/main :: exit 0
node scripts/check-closing-keyword-parity.mjs :: exit 0
node scripts/check-closing-keyword-parity.mjs --self-test :: exit 0
node scripts/check-comment-mask-corpus.mjs :: exit 0
node scripts/check-doc-route-spelling.mjs --advisory :: exit 0
node scripts/check-doc-route-spelling.mjs --self-test :: exit 0
node scripts/check-dts-emitted.mjs --self-test :: exit 0
node scripts/check-empty-changeset.mjs --base origin/main :: exit 0
node scripts/check-empty-changeset.mjs --self-test :: exit 0
node scripts/check-skills-token-ratchet.mjs :: exit 0
node scripts/check-skills-token-ratchet.mjs --self-test :: exit 0
node scripts/ci/assert-turbo-remote-cache.mjs --self-test :: exit 0
node scripts/ci/plan-test-core-shards.mjs --self-test :: exit 0
node scripts/ci/prune-turbo-cache.mjs --self-test :: exit 0
node scripts/pm/release-rehearsal-clone.mjs --self-test :: exit 0
node scripts/release-pending-publish.mjs --self-test :: exit 0
pnpm --filter @objectstack/lint run check:doc-formula-expressions :: exit 0
pnpm --filter @objectstack/spec run check:skill-refs :: exit 0
pnpm check:agent-test-spelling :: exit 0
pnpm check:changeset-gate-self-tests :: exit 0
pnpm check:ci-filter-parity :: exit 0
pnpm check:closed-ceremony-text :: exit 0
pnpm check:corpus-claim-drift :: exit 0
pnpm check:cross-package-test-inputs :: exit 0
pnpm check:doc-authoring :: exit 0
pnpm check:driver-memory-census :: exit 0
pnpm check:dts-closure :: exit 0
pnpm check:dual-build-cjs-loads :: exit 0
pnpm check:gitlink-declared :: exit 0
pnpm check:lean-entry-closure :: exit 0
pnpm check:nul-bytes :: exit 0
pnpm check:pm-governed-merges :: exit 0
pnpm check:pm-skill-id-lint :: exit 0
pnpm check:published-files :: exit 0
pnpm check:refd-timer-probe :: exit 0
pnpm check:role-word :: exit 0
pnpm check:skill-compatibility :: exit 0
pnpm check:skill-frame-sync :: exit 0
pnpm check:skill-identifier-liveness :: exit 0
pnpm check:sourcemap-no-sources-content :: exit 0
pnpm check:watch-hint-literal :: exit 0
pnpm lint :: exit 0
```
</details>
🤖 Generated with [Claude Code](https://claude.com/claude-code)
https://claude.ai/code/session_016WV4czuE7FD4NhcJptgwre
---
_Generated by [Claude
Code](https://claude.ai/code/session_016WV4czuE7FD4NhcJptgwre)_
Co-authored-by: Claude <noreply@anthropic.com>1 parent d003d3e commit 1120389
2 files changed
Lines changed: 9 additions & 1 deletion
File tree
- .changeset
- skills/objectstack-platform/references
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
102 | 102 | | |
103 | 103 | | |
104 | 104 | | |
105 | | - | |
| 105 | + | |
106 | 106 | | |
107 | 107 | | |
108 | 108 | | |
| |||
0 commit comments