← 返回 Skills 市场

a2a-Market-Order-State-Machine

Name: a2a-Market-Order-State-Machine
Author: luoqianchenguni-max

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

cross-platform ✓ 安全检测通过

206

总下载

当前安装

版本数

在 OpenClaw 中安装

/install a2a-market-order-state-machine

功能描述

Define order lifecycle states, transition guards, and recovery paths for A2A transactions. Use when implementing order orchestration from quote acceptance th...

使用说明 (SKILL.md)

a2a-Market Order State Machine

Define the canonical order lifecycle and transition guard framework.

Current status: first-release scaffold for early protocol compatibility.

Scope

Model order states from creation to completion/cancelation.
Enforce legal transitions with guard checks and side effects.
Integrate payment and reputation triggers into state changes.

Suggested Project Layout

app/domain/order/order_state.py
app/domain/order/order_aggregate.py
app/application/usecases/transition_order.py
app/application/services/order_event_publisher.py

Minimum Contracts (MVP P0)

create_order(intent_id, accepted_quote_id) initializes order in CREATED.
transition(order_id, action, actor, payload) validates and applies state move.
get_order_timeline(order_id) returns ordered transition history.
recover_pending_orders(now_ts) handles timeout and stuck states.

Base States

CREATED
NEGOTIATING
PAYMENT_PENDING
PAID
FULFILLING
COMPLETED
CANCELED
FAILED

Events

Emit ORDER_CREATED at initialization.
Emit ORDER_COMPLETED when terminal success is reached.
Emit reputation update trigger after completion/cancel resolution.

Implementation Backlog

Add compensation transitions for partial fulfillment failures.
Add deterministic replay from event store snapshots.

Runtime Implementation

Status: implemented in local runtime package.
Primary code paths:
runtime/src/domain/order-state-machine.js
Validation: covered by runtime/tests and npm test in runtime/.

安全使用建议

This skill is a design scaffold only—it contains high-level requirements, state names, and suggested file layout but no code or install steps. It does not ask for credentials or attempt to run commands. Before adopting it, confirm whether you need an actual implementation: the SKILL.md references a local runtime package and tests that are not bundled here, so you should review the real runtime code (and any payment/reputation integration code) in your repository to ensure credential handling and external calls are implemented securely. If you expect the skill to provide runnable code, request the implementation or a trusted package; otherwise using this as a spec/template is reasonable and low-risk.

功能分析

Type: OpenClaw Skill Name: a2a-market-order-state-machine Version: 0.2.0 The skill bundle contains architectural documentation and a state machine framework for managing order lifecycles in A2A transactions. The SKILL.md file provides high-level design patterns, state definitions (e.g., CREATED, PAID, COMPLETED), and suggested project structures without any executable code, suspicious network calls, or prompt injection attempts.

能力评估

✓ Purpose & Capability

The name and description match the SKILL.md content: it describes order lifecycle states, transitions, and recovery. There are no unrelated required binaries, env vars, or config paths. One minor note: the SKILL.md claims an implementation exists in a local runtime package (paths and tests cited) but no code files are included in the skill bundle; this is a documentation/packaging mismatch rather than a coherence/security problem.

✓ Instruction Scope

The instructions are high-level design guidance (states, events, suggested project layout, MVP contracts). They do not instruct the agent to read system files, fetch secrets, call external endpoints, or execute commands. The references to running `npm test` and runtime file paths are informational and do not direct the agent to perform actions outside the stated scope.

✓ Install Mechanism

No install spec provided (instruction-only). Nothing will be downloaded or written to disk by the skill itself.

✓ Credentials

The skill does not request any environment variables, credentials, or config paths. This is proportionate for a design/scaffold skill. Implementers should note that when they implement payment or reputation integrations in their own code, those integrations will require appropriate credentials handled outside this skill.

✓ Persistence & Privilege

The skill is not marked always:true and does not appear to request or modify persistent agent or system configuration. Autonomous invocation is allowed by platform default but the skill's instructions do not give it special persistence or elevated privileges.

如何使用

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

版本历史

v0.2.0

sync runtime implementation and validation coverage

v0.1.0

initial scaffold for early registration

元数据

Slug a2a-market-order-state-machine

版本 0.2.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题