Skip to content

docs: browse / search --type 需要 0.1.3;版本 0.1.4 - #10

Merged
KirbyInGitHub merged 1 commit into
mainfrom
docs/min-version-browse
Sep 13, 2026
Merged

KirbyInGitHub merged 1 commit into
mainfrom
docs/min-version-browse

Conversation

@KirbyInGitHub

Copy link
Copy Markdown
Contributor
问题 修法 测试
C1 最低版本写错:skills/cortex-org-wiki/SKILL.md 写 "Version 0.1.0 or later supports these commands",docs/agent-setup.md 写「当前最低版本 0.1.0」,但 browsesearch --type 从 0.1.3 才有。旧版本的 yargs .strict() 会把它们当成输入错误拒绝,退出码 3。在已发布的 0.1.2 上实测:browse --type projectsearch topic --type project 都返回 kind: validation,exit 3。 skill、Agent 指南、README 都写明:browsesearch --type 需要 0.1.3 及以上,版本以 cortex-org-wiki --version 为准,旧版本以退出码 3 拒绝,其余命令自 0.1.0 起可用;skill 和指南还写了版本偏旧时先按指南更新。skill 正文编进了二进制,所以版本升到 0.1.4(package.json、package-lock.json),并用 scripts/generate-assets.mjs 重新生成 src/version.tssrc/skillAsset.ts tests/cli.test.ts 新增子测试:三份文档都要写出 browsesearch --type 需要 0.1.3,并且不再出现 0.1.0 是整体最低版本的说法;另外要求 --version 高于 0.1.3,保证改过的内嵌 skill 以新版本号发出。修复前运行:该子测试失败(SKILL.md 不匹配),修复后通过。

共享边界

  • 消费者:内嵌 skill 会被三处用到:skill setup、原生安装器、市场 skill 打包(scripts/package-skill.mjsmetadata.cli.version 写成 0.1.4)。只改了文字,命令、参数、退出码和 API 调用都没动。
  • 本 PR 不发布、不打 tag。0.1.4 在合并后再发布(npm、GitHub Release、CDN、市场),发布记录等发布完成后再写进 docs/release.md
  • 没有经过发布流程的安装方式,比如 CDN 上的 agent-setup.md 和市场 skill,发布前仍是 0.1.3 的旧文字。

检查

  • npm test:13 项里 12 项通过、0 失败,1 项跳过(native 需要 CORTEX_ORG_WIKI_TEST_BINARY,本地未设置,CI 会跑)
  • 修复前加上新测试运行 npm test:exit 1,只有新增子测试失败
  • 从 npm 装 @hiq-ai/cortex-org-wiki-cli@0.1.2 实测:browse / search --type 均 exit 3
  • 构建后 node dist/cli.js --version 输出 0.1.4dist/skillAsset.js 里是新文字
  • 未验证:native 二进制与安装器测试(交给 CI)、真实发布渠道

🤖 Generated with Claude Code

https://claude.ai/code/session_01SyjxHtzc5bneQgSH85QULN

The skill said 0.1.0 or later supports its commands and the agent guide said
the minimum was 0.1.0, but browse and search --type only exist from 0.1.3;
older binaries reject them as invalid input (exit 3, verified on 0.1.2).
State the real minimum and how to check it in the skill, agent guide and
README. The skill is embedded in the binary, so bump to 0.1.4 and
regenerate the version and skill assets.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SyjxHtzc5bneQgSH85QULN
@KirbyInGitHub
KirbyInGitHub merged commit 35aac9b into main Sep 13, 2026
2 checks passed
@KirbyInGitHub
KirbyInGitHub deleted the docs/min-version-browse branch September 13, 2026 06:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant