用途
本技能（dym-archify-install-and-verify）用于把 Archify 安装进 agent harness，并证明它确实能运行。Archify 不是可以 import 的库，而是一个技能包（根目录含 SKILL.md 的文件夹）外加一个 Node CLI。在它被放到 agent 扫描技能的正确位置、并且运行时条件被验证通过之前，它不会做任何事。
完成后的预期结果：archify/ 目录位于 harness 的技能路径中，doctor 检查全绿，并生成一个可在浏览器中打开的 HTML 演示文件。
前置条件
- Node.js >= 18，依据 archify/package.json 的 engines.node。项目 CI 覆盖 18、20、22、24。
- 不需要 npm install。已验证：清空 node_modules 后运行 validate 仍然通过。devDependencies（ajv、parse5、saxes、simple-icons）仅用于 Archify 自身的测试/构建。
- 已验证的警告：archify/package.json 中 "private": true，且该包未发布到 npm，因此 npx archify … 无法运行。本套件中的所有命令都直接调用 node <skill>/bin/archify.mjs。
使用方式
方式 A — 通过 CLI skills 安装（README 推荐路径）
npx skills add tt-a1i/archify -g
非交互、明确指定 harness：
npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes
不安装直接试用：
npx skills use tt-a1i/archify@archify --agent codex
--agent 接受 cursor、codex、claude-code、opencode。
本次探索中尚未验证：skills 是第三方 CLI，且需要网络。如果它失败或你不想引入依赖，请使用方式 B。
方式 B — 手动安装（已通过目录结构验证）
安装单元是仓库内的 archify/ 目录，其中包含 SKILL.md、bin/、renderers/、schemas/、examples/、references/。
git clone https://github.com/tt-a1i/archify.git /tmp/archify-src
cp -R /tmp/archify-src/archify ~/.claude/skills/archify
各 harness 的安装路径（取自 README 的 "Installation options" 表）：
- Claude Code：~/.claude/skills/archify 或 .claude/skills/archify
- Codex CLI：~/.agents/skills/archify 或 .agents/skills/archify
- opencode：~/.config/opencode/skills/archify、.opencode/skills/archify 或 .agents/skills/archify
- Raven：将 archify.zip 解压到 ~/.raven/workspace/skills → ~/.raven/workspace/skills/archify
- Claude.ai：将 archify.zip 上传到 Settings → Capabilities → Skills
快速检查目录层级是否正确：
test -f ~/.claude/skills/archify/SKILL.md && echo "layout ok" || echo "sai tầng — bạn đang copy nhầm repo root"
常见错误：复制了整个仓库根目录（archify-src/）而不是子目录 archify/。此时 SKILL.md 会深一层，harness 找不到该技能。
验证运行
cd ~/.claude/skills/archify
node bin/archify.mjs doctor
实际运行结果（macOS，Node v22.17.0）：
Archify doctor
[ok] Node.js v22.17.0 (requires >=18)
[ok] Core template
[ok] Example renderer
[ok] Live preview runtime
[ok] Visual-check runtime
[ok] Output path safety runtime
[ok] Scenario recipe guide
[ok] Progressive authoring references
[ok] Architecture compare runtime and proof fixtures
[ok] Standalone schema validators
[ok] architecture renderer, schema, and example
[ok] workflow renderer, schema, and example
[ok] sequence renderer, schema, and example
[ok] dataflow renderer, schema, and example
[ok] lifecycle renderer, schema, and example
Archify is ready.
退出码：打印 Archify is ready. 时为 0；打印 Archify is not ready: …（Node 过旧、缺文件或运行时检查失败）时为 1。来源：bin/archify.mjs 中的 commandDoctor()，约第 1348 行。
生成一个真实产物以便肉眼查看：
node bin/archify.mjs demo /tmp/archify-demo
open /tmp/archify-demo/archify-demo.html # Linux: xdg-open
已运行：生成 /tmp/archify-demo/archify-demo.html（约 698 KB，单个自包含 HTML 文件），rc 0，并打印下一步建议。
关闭联网更新检查
Archify 可能 GET 一个固定 manifest，仅用于显示提示；它从不下载或自动安装新版本。完全关闭网络部分和提示状态写入：
export ARCHIFY_UPDATE_CHECK_DISABLED=1
验证：scripts/check-update.mjs:1637 在该变量等于 1 时立即提前退出。
两个快速探测命令
node bin/archify.mjs --help # 打印 usage，rc 0
node bin/archify.mjs bogus # 打印 "Unknown command" + usage，rc 2
2 是 Archify 的用法错误退出码，不是 1。在编写 wrapper 脚本前请记住这一点。
适用场景与限制
适用于需要把 Archify 技能包部署到 Claude Code、Codex CLI、opencode、Raven 或 Claude.ai 等 harness，并验证其运行时是否就绪的场景。限制：需要 Node.js >= 18；包为 private 且未发布到 npm，不能通过 npx archify 调用；方式 A 依赖第三方 skills CLI 和网络，本次未验证；安装时必须复制 archify/ 子目录而非仓库根目录。