← Back to Skills Marketplace
a2a-Market-Order-State-Machine
by
luoqianchenguni-max
· GitHub ↗
· v0.2.0
· MIT-0
206
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install a2a-market-order-state-machine
Description
Define order lifecycle states, transition guards, and recovery paths for A2A transactions. Use when implementing order orchestration from quote acceptance th...
README (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.pyapp/domain/order/order_aggregate.pyapp/application/usecases/transition_order.pyapp/application/services/order_event_publisher.py
Minimum Contracts (MVP P0)
create_order(intent_id, accepted_quote_id)initializes order inCREATED.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
CREATEDNEGOTIATINGPAYMENT_PENDINGPAIDFULFILLINGCOMPLETEDCANCELEDFAILED
Events
- Emit
ORDER_CREATEDat initialization. - Emit
ORDER_COMPLETEDwhen 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/testsandnpm testinruntime/.
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install a2a-market-order-state-machine - After installation, invoke the skill by name or use
/a2a-market-order-state-machine - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.0
sync runtime implementation and validation coverage
v0.1.0
initial scaffold for early registration
Metadata
Frequently Asked Questions
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 206 downloads so far.
How do I install a2a-Market-Order-State-Machine?
Run "/install a2a-market-order-state-machine" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is a2a-Market-Order-State-Machine free?
Yes, a2a-Market-Order-State-Machine is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does a2a-Market-Order-State-Machine support?
a2a-Market-Order-State-Machine is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created a2a-Market-Order-State-Machine?
It is built and maintained by luoqianchenguni-max (@luoqianchenguni-max); the current version is v0.2.0.
More Skills