Codex/skill unified upgrade 20260227

.github/workflows/coverage-badge.yml

@@ -0,0 +1,34 @@
+name: Coverage Badge
+
+on:
+  push:
+    branches:
+      - main
+      - master
+      - 'codex/**'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  coverage-badge:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - run: bun install --frozen-lockfile
+      - run: bun run test:coverage:ci
+      - run: bun run coverage:badge
+      - run: touch coverage/.nojekyll
+
+      - name: Deploy coverage badge to gh-pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./coverage
+          publish_branch: gh-pages

.github/workflows/publish.yml

@@ -26,8 +26,8 @@ jobs:
       - name: Type check
         run: bunx tsc --noEmit
 
-      - name: Run tests
-        run: bun run test
+      - name: Coverage gate
+        run: bun run test:coverage:ci
 
       - name: Verify generated openclaw config
         run: bun run build:openclaw:check

.github/workflows/test.yml

@@ -29,11 +29,8 @@ jobs:
       - name: Type check
         run: bunx tsc --noEmit
 
-      - name: Run tests
-        run: bun run test
-
-      - name: Unit coverage
-        run: bun run test:unit:coverage
+      - name: Coverage gate
+        run: bun run test:coverage:ci
 
       - name: Verify generated openclaw config
         run: bun run build:openclaw:check

README.md

@@ -1,5 +1,10 @@
 # AelfScan Skill Kit
 
+[English](./README.md) | [中文](./README.zh-CN.md)
+
+[![Unit Tests](https://github.com/AelfScanProject/aelfscan-skill/actions/workflows/test.yml/badge.svg)](https://github.com/AelfScanProject/aelfscan-skill/actions/workflows/test.yml)
+[![Coverage](https://img.shields.io/endpoint?url=https://AelfScanProject.github.io/aelfscan-skill/coverage-badge.json)](https://AelfScanProject.github.io/aelfscan-skill/coverage-badge.json)
+
 AelfScan explorer skill toolkit for AI agents, with **SDK + MCP + CLI + OpenClaw** interfaces.
 
 ## Features
@@ -51,6 +56,13 @@ cp .env.example .env
 bun run mcp
 ```
 
+### OpenClaw
+
+```bash
+bun run build:openclaw
+bun run build:openclaw:check
+```
+
 ### Run CLI
 
 ```bash
@@ -111,3 +123,8 @@ RUN_LIVE_TESTS=1 bun run test:e2e
 ## License
 
 MIT
+
+## Security
+
+- Keep API tokens and private keys in env/config only.
+- Never leak secret values in tool outputs.

README.zh-CN.md

@@ -1,5 +1,10 @@
 # AelfScan Skill Kit
 
+[中文](./README.zh-CN.md) | [English](./README.md)
+
+[![Unit Tests](https://github.com/AelfScanProject/aelfscan-skill/actions/workflows/test.yml/badge.svg)](https://github.com/AelfScanProject/aelfscan-skill/actions/workflows/test.yml)
+[![Coverage](https://img.shields.io/endpoint?url=https://AelfScanProject.github.io/aelfscan-skill/coverage-badge.json)](https://AelfScanProject.github.io/aelfscan-skill/coverage-badge.json)
+
 面向 AI Agent 的 AelfScan 浏览器能力工具包，提供 **SDK + MCP + CLI + OpenClaw** 四种使用方式。
 
 ## 功能覆盖
@@ -51,6 +56,13 @@ cp .env.example .env
 bun run mcp
 ```
 
+### OpenClaw
+
+```bash
+bun run build:openclaw
+bun run build:openclaw:check
+```
+
 ### CLI 示例
 
 ```bash
@@ -111,3 +123,8 @@ RUN_LIVE_TESTS=1 bun run test:e2e
 ## License
 
 MIT
+
+## 安全
+
+- API Token 和私钥仅通过环境变量或配置注入。
+- 工具输出中禁止泄露敏感字段。

SKILL.md

@@ -0,0 +1,32 @@
+---
+name: "aelfscan-skill"
+description: "AelfScan explorer data retrieval and analytics skill for agents."
+---
+
+# AelfScan Skill
+
+## When to use
+- Use this skill when you need AelfScan explorer search and analytics data retrieval tasks.
+
+## Capabilities
+- Domain coverage: search, blockchain, address, token, NFT, statistics
+- Single tool descriptor source for SDK/CLI/MCP/OpenClaw
+- MCP output governance controls and standardized trace-aware errors
+- Supports SDK, CLI, MCP, and OpenClaw integration from one codebase.
+
+## Safe usage rules
+- Never print private keys, mnemonics, or tokens in channel outputs.
+- For write operations, require explicit user confirmation and validate parameters before sending transactions.
+- Prefer `simulate` or read-only queries first when available.
+
+## Command recipes
+- Start MCP server: `bun run mcp`
+- Run CLI entry: `bun run cli`
+- Generate OpenClaw config: `bun run build:openclaw`
+- Verify OpenClaw config: `bun run build:openclaw:check`
+- Run CI coverage gate: `bun run test:coverage:ci`
+
+## Limits / Non-goals
+- This skill focuses on domain operations and adapters; it is not a full wallet custody system.
+- Do not hardcode environment secrets in source code or docs.
+- Avoid bypassing validation for external service calls.

bin/generate-coverage-badge.ts

@@ -46,7 +46,6 @@ const badge = {
   label: 'coverage',
   message: `${rounded}%`,
   color,
-  generatedAt: new Date().toISOString(),
 };
 
 fs.mkdirSync(path.dirname(outputPath), { recursive: true });

bin/generate-openclaw.ts

@@ -15,6 +15,11 @@ const openclaw = {
     command: 'bun',
     args: ['run', 'aelfscan_skill.ts', descriptor.domain, descriptor.action],
     cwd: '.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      additionalProperties: true,
+    },
   })),
 };