Skip to content

docs: add agent-led organization knowledge setup - #5

Closed
KirbyInGitHub wants to merge 1 commit into
mainfrom
feat/agent-knowledge-setup
Closed

KirbyInGitHub wants to merge 1 commit into
mainfrom
feat/agent-knowledge-setup

Conversation

@KirbyInGitHub

@KirbyInGitHub KirbyInGitHub commented Sep 11, 2026 •

Copy link
Copy Markdown
Contributor

原组织知识接入要求用户手动安装 CLI、在终端登录,再下载 ZIP 放入各宿主目录。本次改为一段可复制给 Agent 的请求:Agent 读取正式指南,安装当前宿主的单个 organization-knowledge skill 和所需 CLI,缺少登录时运行已有 login --json 并提供授权链接;用户授权后继续组织身份核验及真实查询。

  • 新增 docs/agent-setup.md,覆盖 macOS/Linux/Windows 与 npm、标准 skills 精准安装、0.5.0 版本门槛、原生 device-flow stderr/进程轮询语义、组织与 revision 约束,以及空结果的准确报告。
  • README 使用短 prompt 和正式指南入口;skill 移除禁止 Agent 安装/登录的旧要求。Cowork 的安装及身份接线尚未验证,不宣称已有原生组织知识工具,也不把 Snowflake 的 --agent cortex 当作 HiQ Cortex。
  • 指南只有一个源文件:npm 包包含原文件;既有 build-binaries.sh 生成 Release 的 agent-setup.md 与 checksum;既有 mirror-to-cdn.sh 从该 Release 复制到版本目录、latest 和稳定的 https://download.hiq.earth/cli/hiq-cortex/agent-setup.md。未新增发布机制,未修改 API/schema/认证实现。

验证:

  • npm test:18/18 通过,包括既有 CLI/HTTP/device-flow fixture、组织和版本边界、clean npm install;新增指南包内容与唯一源文件一致性断言。
  • GitHub CI 的 Ubuntu / Windows 两项测试均通过(run 34624787548)。
  • 官方 skills@1.5.25 对本 PR 提交的公开 GitHub URL 执行 --list,仅发现一个 skill;分别用 --skill organization-knowledge --agent codex|claude-code --yes 安装到独立临时项目,list --json 与逐字节比对通过。npm cache、XDG config/state 均在隔离临时目录。
  • skill 官方 validator、release workflow YAML 解析、两个发布脚本 bash -n、git diff --check 通过;按现有 ZIP 命令验证 skill ZIP 结构,并核对 guide 原文件与 staging 副本。

上线条件:本 PR 只准备发布代码。尚未 merge/tag/release,未向 S3/CDN 写入,未执行真实用户登录或组织查询,未重跑未改动的跨平台二进制构建。引用正式指南入口的产品 UI 必须等待指南和 CLI 正式发布并验证可访问;安装器发现/文件一致性不等于宿主实时加载或线上知识验收。

@KirbyInGitHub

Copy link
Copy Markdown
Contributor Author

Superseded by the standalone cortex-org-wiki CLI and skill in HiQ-AI/cortex-org-wiki-cli#1. The unreleased Wiki entry in this LCA client is removed separately; this onboarding branch will not be merged.

@KirbyInGitHub
KirbyInGitHub deleted the feat/agent-knowledge-setup branch September 13, 2026 15:08
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