{"_id":"@blockchain-forever/aelf-skills","_rev":"3-84a7c025bb0e2cc19c8569aa3c7af3a5","name":"@blockchain-forever/aelf-skills","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.0":{"name":"@blockchain-forever/aelf-skills","version":"0.1.0","license":"MIT","_id":"@blockchain-forever/aelf-skills@0.1.0","maintainers":[{"name":"hzz780","email":"hzz780@qq.com"},{"name":"aelf-project","email":"azure@aelf.io"}],"homepage":"https://github.com/AElfProject/aelf-skills#readme","bugs":{"url":"https://github.com/AElfProject/aelf-skills/issues"},"dist":{"shasum":"c1f63dc3e44a95fe03a994fa763df77eb43d8216","tarball":"https://registry.npmjs.org/@blockchain-forever/aelf-skills/-/aelf-skills-0.1.0.tgz","fileCount":35,"integrity":"sha512-4SbpwR67ub/KkDwyau14zGwHPNbkmQdeXweCjjd/PAWvplFEF7nlunY6bXDCqVZkdJGiTvpfAvqnUt5+SInJrQ==","signatures":[{"sig":"MEUCIQDjvdVZ0d5DsEGT29hfY3iScFSnFNngSm14xMyXw1NdqAIgc5Jy1cpV9mnGGLvsy8AMn6D+EQs9G3Djp8bXNFrNXlk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":124176},"type":"module","engines":{"bun":">=1.1.0"},"gitHead":"5eea979b878c503b7076cb4cd383ec95ee43f674","scripts":{"bootstrap":"bun run scripts/bootstrap.ts","health:check":"bun run scripts/health-check.ts","readme:check":"bun run scripts/check-readme-sync.ts","security:audit":"bun run scripts/security-audit.ts","catalog:generate":"bun run scripts/generate-catalog.ts","catalog:generate:local":"bun run scripts/generate-catalog.ts --include-local-paths --output skills-catalog.local.json --no-readme-sync"},"_npmUser":{"name":"hzz780","email":"hzz780@qq.com"},"repository":{"url":"git+https://github.com/AElfProject/aelf-skills.git","type":"git"},"_npmVersion":"11.6.2","description":"Discovery, download, and configuration hub for the aelf agent skill ecosystem.","directories":{},"_nodeVersion":"24.11.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aelf-skills_0.1.0_1772293515013_0.6974769613151472","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@blockchain-forever/aelf-skills","version":"0.1.3","license":"MIT","_id":"@blockchain-forever/aelf-skills@0.1.3","maintainers":[{"name":"hzz780","email":"hzz780@qq.com"},{"name":"aelf-project","email":"azure@aelf.io"}],"homepage":"https://github.com/AElfProject/aelf-skills#readme","bugs":{"url":"https://github.com/AElfProject/aelf-skills/issues"},"dist":{"shasum":"84c953da53442bbc9d7c9d0603c503b2a3a20aa4","tarball":"https://registry.npmjs.org/@blockchain-forever/aelf-skills/-/aelf-skills-0.1.3.tgz","fileCount":46,"integrity":"sha512-rk71X6I+xR/iVtfB6RHaGKfHuxukz2PhyIUezSIfg70acQOsdoDQLo5Tp6uIx8upYabORVXsKcA0PnbnyTOLjg==","signatures":[{"sig":"MEUCIQDCY41YUD1KBK/NFA5baWGS8eFAC9aqLo7vEzWyearbmAIgV4MlT+ty3dn1Zjs1Us9Y95K1oWfz9nnbYwOMDLrvyk8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@blockchain-forever%2faelf-skills@0.1.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":184957},"type":"module","engines":{"bun":">=1.1.0"},"gitHead":"59924f6df3bdf5a765c5c81cf8c1ed363a420377","scripts":{"bootstrap":"bun run scripts/bootstrap.ts","health:check":"bun run scripts/health-check.ts","readme:check":"bun run scripts/check-readme-sync.ts","update:check":"bun run scripts/update-check.ts","security:audit":"bun run scripts/security-audit.ts","catalog:generate":"bun run scripts/generate-catalog.ts","type-debt:report":"bun run scripts/type-debt-report.ts","test:signer-chain":"bun run scripts/test-signer-chain.ts","update:check:json":"bun run scripts/update-check.ts --json","catalog:generate:local":"bun run scripts/generate-catalog.ts --include-local-paths --output skills-catalog.local.json --no-readme-sync"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:8da37460-98de-47b5-9a34-df2b40f40167"}},"repository":{"url":"git+https://github.com/AElfProject/aelf-skills.git","type":"git"},"_npmVersion":"11.11.0","description":"Discovery, download, and configuration hub for the aelf agent skill ecosystem.","directories":{},"_nodeVersion":"22.22.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aelf-skills_0.1.3_1772647738472_0.18856348259530264","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@blockchain-forever/aelf-skills","version":"0.1.4","description":"Discovery, download, and configuration hub for the aelf agent skill ecosystem.","type":"module","license":"MIT","repository":{"type":"git","url":"git+https://github.com/AElfProject/aelf-skills.git"},"publishConfig":{"access":"public"},"scripts":{"catalog:generate":"bun run scripts/generate-catalog.ts","catalog:generate:local":"bun run scripts/generate-catalog.ts --include-local-paths --output skills-catalog.local.json --no-readme-sync","bootstrap":"bun run scripts/bootstrap.ts","health:check":"bun run scripts/health-check.ts","update:check":"bun run scripts/update-check.ts","update:check:json":"bun run scripts/update-check.ts --json","type-debt:report":"bun run scripts/type-debt-report.ts","test:signer-chain":"bun run scripts/test-signer-chain.ts","readme:check":"bun run scripts/check-readme-sync.ts","security:audit":"bun run scripts/security-audit.ts"},"engines":{"bun":">=1.1.0"},"gitHead":"ba15f2fb6ffeeabf5b3568df616659528bf6463c","_id":"@blockchain-forever/aelf-skills@0.1.4","bugs":{"url":"https://github.com/AElfProject/aelf-skills/issues"},"homepage":"https://github.com/AElfProject/aelf-skills#readme","_nodeVersion":"22.22.1","_npmVersion":"11.12.1","dist":{"integrity":"sha512-rxkRNsAFBqdZWtR11w43CrkXbH/rRT8YqaI9irrgE7IwRRuiXBcSP0Y6Asi1fEeFJk4s72f05I3uRv7GElzOYw==","shasum":"1dd6ad540b14644967542632247047a3532cfb92","tarball":"https://registry.npmjs.org/@blockchain-forever/aelf-skills/-/aelf-skills-0.1.4.tgz","fileCount":47,"unpackedSize":210341,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@blockchain-forever%2faelf-skills@0.1.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCIICBoIpMIx2u+8C1BIXrXtVdgHQ8OKWdGw4a7MNajsAIgIkXlieMjEZ/YRIG5RIcnXkUzrl5lyzVIh98v9ybzVZ0="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:8da37460-98de-47b5-9a34-df2b40f40167"}},"directories":{},"maintainers":[{"name":"hzz780","email":"hzz780@qq.com"},{"name":"aelf-project","email":"azure@aelf.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/aelf-skills_0.1.4_1774853134789_0.6796828192390902"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-28T15:45:14.915Z","modified":"2026-03-30T06:45:35.310Z","0.1.0":"2026-02-28T15:45:15.173Z","0.1.3":"2026-03-04T18:08:58.636Z","0.1.4":"2026-03-30T06:45:34.978Z"},"bugs":{"url":"https://github.com/AElfProject/aelf-skills/issues"},"license":"MIT","homepage":"https://github.com/AElfProject/aelf-skills#readme","repository":{"type":"git","url":"git+https://github.com/AElfProject/aelf-skills.git"},"description":"Discovery, download, and configuration hub for the aelf agent skill ecosystem.","maintainers":[{"name":"hzz780","email":"hzz780@qq.com"},{"name":"aelf-project","email":"azure@aelf.io"}],"readme":"中文 | [English](README.md)\n\n# aelf Skills\n\n这是 aelf 技能生态的统一发现与 bootstrap 入口。\n\n[![npm](https://img.shields.io/npm/v/@blockchain-forever/aelf-skills)](https://www.npmjs.com/package/@blockchain-forever/aelf-skills)\n\n本仓库提供：\n1. 面向人类与 AI 的双语入口文档。\n2. 机器可读目录：`skills-catalog.json`。\n3. 一键脚本：`bootstrap.sh`。\n\n## AI 快速指令（OpenClaw / Codex / Cursor / Claude Code）\n\n```text\n仓库：https://github.com/AElfProject/aelf-skills\n这是一个跨客户端通用指令，可用于 OpenClaw、Codex、Cursor、Claude Code。\n先读取：skills-catalog.json、docs/SKILL_ROUTING_MATRIX.zh-CN.md、docs/AI_E2E_SCENARIOS.zh-CN.md。\n然后执行：\n1) ./bootstrap.sh --source github --dest ./downloaded-skills\n2) bun run health:check -- --skills-root ./downloaded-skills\n3) 读取 `skills-catalog.json` 里的 `clientInstall.openclaw` / `clientInstall.ironclaw`；若存在 `installCommand`，由宿主或 agent 在本地执行，而不是把 GitHub tree URL 当成最终安装输入\n路由规则：按 SKILL_ROUTING_MATRIX；若有歧义，输出 Recommended/Alternative/Reason。\n失败规则：按 docs/AI_E2E_SCENARIOS.zh-CN.md 的常见错误恢复模板执行。\n```\n\n## 范围说明\n\n本入口仓只负责 **发现、下载、安装、能力索引**。\n\n不会替代各 skill 仓内部客户端接入逻辑。\n`OpenClaw`、`Cursor`、`Claude Desktop`、`IronClaw`、`Codex`、`Claude Code` 的具体接入仍由各 skill 仓负责。\nAI Agent 可直接跳转到 [AI 导航入口](#ai-导航入口) 查看路由与执行指引。\n\n## Discovery 与 Activation\n\nSkill 分发一律拆成两个阶段：\n1. `discovery`：GitHub repo URL / npm package / ClawHub slug 负责让宿主发现 skill。\n2. `activation`：宿主或 agent 读取 `skills-catalog.json` 中的机器契约并执行安装命令。\n\n固定规则：\n1. GitHub tree/repo URL 只用于 discovery，不是 IronClaw 的最终安装载体。\n2. IronClaw 一律优先读取 `clientInstall.ironclaw.installCommand`，并预期存在 trusted 本地安装步骤。\n3. OpenClaw 若存在 `distributionSources.clawhubId`，优先走 `ClawHub` / managed install；否则回退到 `clientInstall.openclaw.installCommand`。\n\n## 环境依赖\n\n- `bun >= 1.1.0`（硬要求）\n- `npm >= 10`\n- `git >= 2.39`\n- `tar`（GNU tar 或 bsdtar）\n\n## 本地环境配置\n\n`workspace.json` 使用 `${SKILLS_BASE}` 占位路径以保证可移植性。\n`workspace.json` 仅用于 Codex 本地工作区配置；外部消费者请直接使用 `skills-catalog.json` 作为数据源。\n\n```bash\nexport SKILLS_BASE=/path/to/your/workspace\n```\n\n示例：\n- `${SKILLS_BASE}/AElf/aelf-node-skill`\n- `${SKILLS_BASE}/awaken/awaken-agent-skills`\n\n## 安装\n\n```bash\nnpm install @blockchain-forever/aelf-skills\n# 或\nbun add @blockchain-forever/aelf-skills\n```\n\n## 快速开始\n\n```bash\n# 1) 生成公开 catalog 并同步 README 表格\nbun run catalog:generate\n\n# 2) 生成包含 sourcePath 的本地 catalog（用于本地 bootstrap/health）\nbun run catalog:generate:local\n\n# 3) 执行基础门禁\nbun run health:check\nbun run readme:check\nbun run security:audit\n\n# 4) 拉起指定 skill\n./bootstrap.sh --only aelf-node-skill --skip-install\n\n# 5) 检查 hub/catalog 版本漂移（非阻塞）\nbun run update:check\n```\n\n## Bootstrap 命令\n\n```bash\n./bootstrap.sh [--catalog <path>] [--dest <dir>] [--source auto|npm|github|local] [--skip-install] [--skip-health] [--only <csv>]\n```\n\n默认行为：\n1. `--source auto`（先 npm，失败回退 github）\n2. 默认执行 install\n3. 默认执行 health\n4. 默认使用 `skills-catalog.json`\n\n## 更新自检\n\n`aelf-skills` 内置了更新提醒，会在 `bootstrap`、`health:check`、`catalog:generate` 运行时做非阻塞检测。\n检测结果使用本地缓存（默认 TTL 24 小时），不会阻塞主流程。\n提醒输出会基于 `lastNotifiedAt` 做节流：默认 24 小时内最多提示一次。\n\n命令：\n1. `bun run update:check`\n2. `bun run update:check -- --force`\n3. `bun run update:check:json`\n\n环境变量：\n1. `AELF_SKILLS_UPDATE_CHECK=0|1`（默认 `1`）\n2. `AELF_SKILLS_UPDATE_TTL_HOURS=24`（默认 `24`）\n3. `AELF_SKILLS_UPDATE_CACHE_PATH=<path>`（默认 `~/.aelf-skills/update-check-cache.json`）\n\n## 机器清单说明\n\n`skills-catalog.json` 是稳定机器接口。\n\n每个 skill 关键字段：\n1. `id`, `displayName`\n2. `npm`（`name`, `version`）\n3. `repository.https`\n4. `distributionSources`（`githubRepo`, `npmPackage`，以及可选 `clawhubId`）\n5. `description`, `capabilities`\n6. `artifacts`（`skillMd`, `mcpServer`, `openclaw`）\n7. `setupCommands`（兼容展示字段，例如 `claudeDesktop`、`cursor`、`openclaw`、`ironclaw`）\n8. `clientSupport`（支持矩阵，例如 `claude_desktop`、`cursor`、`ironclaw`、`codex`）\n9. `clientInstall`（`openclaw` / `ironclaw` 的机器可执行安装契约）\n10. `dependsOn`（可选，schema `1.3.0`）\n\nSchema 参考：\n1. `docs/schemas/workspace.schema.json`\n2. `docs/schemas/skill-frontmatter.schema.json`\n3. `docs/schemas/openclaw.schema.json`\n4. `docs/schemas/skills-catalog.schema.json`\n\nSchema 演进规则：\n1. `patch`（`1.3.x`）：文案/文档修订，不改变字段语义。\n2. `minor`（`1.x.0`）：向后兼容的字段新增。\n3. `major`（`x.0.0`）：仅用于破坏性变更。\n\n## AI 导航入口\n\n1. Catalog 字段语义：[docs/CATALOG_SCHEMA.zh-CN.md](docs/CATALOG_SCHEMA.zh-CN.md) | [docs/CATALOG_SCHEMA.md](docs/CATALOG_SCHEMA.md)\n2. Intent 路由矩阵：[docs/SKILL_ROUTING_MATRIX.zh-CN.md](docs/SKILL_ROUTING_MATRIX.zh-CN.md) | [docs/SKILL_ROUTING_MATRIX.md](docs/SKILL_ROUTING_MATRIX.md)\n3. 端到端执行场景（含恢复建议）：[docs/AI_E2E_SCENARIOS.zh-CN.md](docs/AI_E2E_SCENARIOS.zh-CN.md) | [docs/AI_E2E_SCENARIOS.md](docs/AI_E2E_SCENARIOS.md)\n4. Type Safety 基线与推进状态：[docs/TYPE_SAFETY_MATRIX.zh-CN.md](docs/TYPE_SAFETY_MATRIX.zh-CN.md) | [docs/TYPE_SAFETY_MATRIX.md](docs/TYPE_SAFETY_MATRIX.md)\n\n## 当前技能快照\n\n该表由 `bun run catalog:generate` 自动同步。\n\n<!-- SKILL_TABLE_START -->\n| ID | npm 包名 | 版本 | OpenClaw 工具数 | 描述 |\n|---|---|---:|---:|---|\n| aelf-node-skill | @blockchain-forever/aelf-node-skill | 0.1.3 | 11 | AElf 节点查询与合约调用技能。 |\n| aelfscan-skill | @aelfscan/agent-skills | 0.2.2 | 61 | AelfScan 浏览器数据检索与分析技能。 |\n| awaken-agent-skills | @awaken-finance/agent-kit | 1.2.4 | 11 | Awaken DEX 交易与行情数据技能。 |\n| eforest-agent-skills | @eforest-finance/agent-skills | 0.4.3 | 48 | eForest 代币与 NFT 市场操作技能。 |\n| portkey-ca-agent-skills | @portkey/ca-agent-skills | 2.3.0 | 32 | Portkey CA 钱包注册、认证、Guardian 与转账技能。 |\n| portkey-eoa-agent-skills | @portkey/eoa-agent-skills | 1.2.6 | 21 | Portkey EOA 钱包与资产操作技能。 |\n| tomorrowdao-agent-skills | @tomorrowdao/agent-skills | 0.2.0 | 44 | TomorrowDAO 治理、BP 与资源操作技能。 |\n<!-- SKILL_TABLE_END -->\n\n## 健康检查\n\n若检查失败，请参考 [常见错误恢复模板](docs/AI_E2E_SCENARIOS.zh-CN.md#常见错误恢复模板)。\n\n```bash\n# 检查 workspace.json 中的本地源仓\nbun run health:check\n\n# 检查指定下载目录\nbun run health:check -- --skills-root ./downloaded-skills\n```\n\n## 安全边界\n\n1. `bootstrap` 不执行 setup 命令。\n2. `bootstrap` 仅做下载、可选依赖安装、health 检查。\n3. 使用 `bun run security:audit` 检测 setup 命令风险模式。\n\n## CI 门禁\n\nCI workflow：`.github/workflows/gates.yml`\n\n基于 fixture 的稳定门禁：\n1. 使用 `testdata/workspace.ci.json` 执行 `catalog:generate`\n2. 对 fixture catalog 执行 `health:check`\n3. 执行 `readme:check`\n4. 执行 `security:audit`\n5. 执行 `bootstrap --only fixture-node-skill --source local --skip-install`\n\n## 贡献规范\n\n1. 贡献规范：[CONTRIBUTING.zh-CN.md](CONTRIBUTING.zh-CN.md) | [CONTRIBUTING.md](CONTRIBUTING.md)\n2. AI 执行契约：[docs/AI_SKILL_CONTRACT.zh-CN.md](docs/AI_SKILL_CONTRACT.zh-CN.md) | [docs/AI_SKILL_CONTRACT.md](docs/AI_SKILL_CONTRACT.md)\n3. AI Prompt 模板：[docs/templates/AI_NEW_SKILL_PROMPT.zh-CN.md](docs/templates/AI_NEW_SKILL_PROMPT.zh-CN.md) | [docs/templates/AI_NEW_SKILL_PROMPT.md](docs/templates/AI_NEW_SKILL_PROMPT.md)\n4. PR 自检清单：[docs/templates/NEW_SKILL_CHECKLIST.zh-CN.md](docs/templates/NEW_SKILL_CHECKLIST.zh-CN.md) | [docs/templates/NEW_SKILL_CHECKLIST.md](docs/templates/NEW_SKILL_CHECKLIST.md)\n5. SKILL 模板：[docs/templates/SKILL_TEMPLATE.zh-CN.md](docs/templates/SKILL_TEMPLATE.zh-CN.md) | [docs/templates/SKILL_TEMPLATE.md](docs/templates/SKILL_TEMPLATE.md)\n6. 黄金路径示例：[docs/examples/EXAMPLE_NEW_SKILL_DIFF.zh-CN.md](docs/examples/EXAMPLE_NEW_SKILL_DIFF.zh-CN.md) | [docs/examples/EXAMPLE_NEW_SKILL_DIFF.md](docs/examples/EXAMPLE_NEW_SKILL_DIFF.md)\n","readmeFilename":"README.zh-CN.md"}