← 返回 Skills 市场

a2a-Market-Compute-Ledger

Name: a2a-Market-Compute-Ledger
Author: luoqianchenguni-max

作者 luoqianchenguni-max · GitHub ↗ · v0.2.0 · MIT-0

cross-platform ⚠ suspicious

223

总下载

当前安装

版本数

在 OpenClaw 中安装

/install a2a-market-compute-ledger

功能描述

Manage compute account ledgers, frozen balances, charge events, and settlement records for A2A commerce flows. Use when implementing or operating compute bil...

使用说明 (SKILL.md)

\r \r

a2a-Market Compute Ledger\r

\r Build and operate the compute ledger module for RealMarket A2A runtime.\r \r Current status: scaffold-first skill for early registration. Keep APIs stable, add production logic incrementally.\r \r

Scope\r

Own ComputeAccount domain object, balance snapshots, and immutable transaction journal.\r
Support reserve/freeze before negotiation and final debit after order confirmation.\r
Emit billing events to event bus for reputation, websocket push, and finance logs.\r \r

Suggested Project Layout\r

app/domain/entities/compute_account.py\r
app/application/services/billing_service.py\r
app/infrastructure/db/ledger_repository.py\r
app/infrastructure/tasks/reconcile_ledger.py\r \r

Minimum Contracts (MVP P0)\r

freeze(account_id, amount, reason) returns hold id and expiry.\r
capture_hold(hold_id, order_id) converts hold to settled charge.\r
release_hold(hold_id) unlocks unused balance.\r
list_ledger_entries(account_id, from_ts, to_ts) returns ordered journal records.\r \r

Event Mapping\r

On hold created: emit INTENT_CREATED + billing extension payload.\r
On charge captured: emit ORDER_CREATED and settlement payload.\r
On charge finalized: emit PAYMENT_SUCCEEDED.\r \r

Guardrails\r

Use integer minor units for money; avoid float math.\r
Enforce idempotency key on every mutating operation.\r
Keep journal append-only; never rewrite posted entries.\r \r

Implementation Backlog\r

Add double-entry validation rules.\r
Add monthly statement export and audit tooling.\r \r

Runtime Implementation\r

Status: implemented in local runtime package.\r
Primary code paths:\r
runtime/src/domain/compute-ledger.js\r
Validation: covered by runtime/tests and npm test in runtime/.\r

安全使用建议

This skill looks like a design/spec for a compute-account ledger rather than a ready-to-run component. Before installing or enabling it: 1) Ask the author for the repository or runtime package they reference (the SKILL.md names runtime/src/domain/compute-ledger.js and npm tests) — those files are not present. 2) Clarify whether the intended implementation is Python or JavaScript (the doc suggests both). 3) Confirm what external systems (event bus, websocket, finance logs, DB) it will need and what credentials/config will be required; do not provide secrets until you verify the code and trust the source. 4) Request concrete tests and an install/run procedure if you expect the agent to execute 'npm test' or other commands. Given the inconsistencies, treat this skill as a specification scaffold rather than a deployable integration until those questions are answered.

功能分析

Type: OpenClaw Skill Name: a2a-market-compute-ledger Version: 0.2.0 The skill bundle defines architectural requirements and functional contracts for a compute ledger and billing system. The instructions in SKILL.md focus on standard financial software practices such as idempotency, integer-based currency handling, and append-only journals, with no evidence of malicious intent, data exfiltration, or harmful prompt injection.

能力评估

ℹ Purpose & Capability

The name and description describe a ledger/billing component and the SKILL.md lists sensible domain APIs and guardrails for that purpose. However, the doc both suggests a Python project layout and also claims an existing JS runtime implementation (runtime/src/domain/compute-ledger.js), which is inconsistent with an instruction-only, scaffold-first skill that includes no code. That mismatch is unexplained.

ℹ Instruction Scope

SKILL.md stays within the stated domain (freeze/capture/release holds, append-only journal, event emission). It does not explicitly instruct the agent to read unrelated system files or exfiltrate secrets. But it references local runtime code paths and 'npm test' as validation, which could lead an agent to look for or execute local files/tools that are not provided; the doc is high-level and leaves much implementation choice to the operator.

✓ Install Mechanism

No install spec is provided (instruction-only), so nothing is written to disk by an installer. That is the lowest-risk install footprint.

✓ Credentials

The skill declares no required environment variables, credentials, or config paths. The listed functionality (emitting events, writing finance logs) would normally require integration credentials, but none are requested here — the absence is reasonable for a scaffold/instruction document but should be clarified before deployment.

✓ Persistence & Privilege

always is false and the skill does not request persistent presence or modify other skills. There is no install-time behavior that would grant it elevated platform privileges.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install a2a-market-compute-ledger
安装完成后，直接呼叫该 Skill 的名称或使用 /a2a-market-compute-ledger 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v0.2.0

sync runtime implementation and validation coverage

v0.1.0

initial scaffold for early registration

元数据

Slug a2a-market-compute-ledger

版本 0.2.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题