diagnose-order
Diagnose Shopify order retrieval, lifecycle, payment, fulfillment, return, refund, webhook, Markets and B2B discrepancies.
- License 许可
- Apache-2.0
- 最近更新
- 2026-09-05
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- diagnose-order
- description
- Diagnose Shopify order retrieval, lifecycle, payment, fulfillment, return, refund, webhook, Markets and B2B discrepancies.
02 资源文件 18
- 参考文档knowledge/community-cases.json8.5 KB
- 参考文档patterns/creation-and-editing.md623 B
- 参考文档patterns/fulfillment-and-shipping.md590 B
- 参考文档patterns/index.json2.2 KB
- 参考文档patterns/markets-b2b-and-money.md530 B
- 参考文档patterns/payment-and-transactions.md539 B
- 参考文档patterns/retrieval-and-access.md606 B
- 参考文档patterns/returns-refunds-cancellations.md573 B
- 参考文档patterns/version-pagination-and-platform.md609 B
- 参考文档patterns/webhooks-and-consistency.md561 B
- 其他queries/order-diagnostic.graphql1.5 KB
- 其他queries/orders-by-reference.graphql278 B
- 参考文档references/official-behavior.md800 B
- 脚本scripts/analyze-webhook-log.mjs863 B
- 脚本scripts/classify-order-issue.mjs644 B
- 脚本scripts/compare-order-snapshots.mjs1.0 KB
- 脚本scripts/run-order-query.mjs2.4 KB
- 脚本tests/order-skill.test.mjs3.5 KB
03 SKILL.md 正文
Diagnose a Shopify order
For a configured metafield term, use shopify/shared/metafields/resolve-metafield-term.mjs with owner type ORDER or DRAFT_ORDER, then build the read-only object query with build-metafield-query.mjs. Require an identified object and never infer a namespace or key.
- Resolve
config-nameplus environment withshopify/shared/config/load-config.mjs; never infer a shop or reuse another environment's credentials. - Run
scripts/classify-order-issue.mjsand read only its highest-scoringpatterns/file. Loadknowledge/community-cases.jsononly when comparable cases are needed. - Start with
queries/order-diagnostic.graphql. Minimize protected customer data and redact it from evidence. - Compare original versus current money, quantities and lifecycle states. Correlate fulfillment-order line IDs, transactions, refunds, returns, events and webhook identifiers rather than assuming one status explains the order.
- Capture HTTP status, GraphQL errors,
userErrors, request ID, API version, shop, timestamps and query cost. Validate any forum hypothesis against current Shopify documentation. - Report finding, evidence, confidence, unresolved gaps and the smallest safe next action.
Reads are the default. Never create, edit, cancel, capture, refund, return, fulfill or close an order without explicit authorization for that operation and resolved shop. Use --allow-mutation only after authorization.
04 同仓库更多 Skills
diagnose-spring-boot
Diagnose Spring Boot application failures, behavior, configuration, security, data access, messaging, tests, observability, and runtime issues across explicitly resolved enterprise environments and services.
diagnose-storefront-api
Diagnose cross-cutting Shopify Storefront GraphQL authentication, context, publication, version, throttling, Hydrogen transport and response failures; route resource-specific failures to their domain skill.
diagnose-product
Diagnose Shopify product, variant, option, inventory, media, metafield, publication, search and bulk-operation failures across configured shops and environments.
diagnose-discount
Diagnose Shopify discount configuration, eligibility, Functions, combinations, markets, B2B, and cart or checkout outcomes without changing discounts.
diagnose-customer
Diagnose Shopify customer identity, profile, access, and cross-storefront failures while keeping Admin, Storefront, and Customer Account API evidence separate.
diagnose-cart
Diagnose Shopify Storefront API, Hydrogen, and theme cart failures across configured storefronts and environments without mutating carts by default.