← Back to Skills Marketplace
modeyapu

data-flow-review

by ModeYapu · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
40
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install data-flow-review
Description
Review business workflows for branch-state consistency, key field semantics, and end-to-end data correctness. Use when Codex needs to trace a flow, inspect b...
README (SKILL.md)

Flow Data Review

Trace the real code path before judging any field. Prefer actual callers, store writes, and request builders over comments or interface names.

Reconstruct The Flow

  1. Find the entry page, downstream pages, and every API wrapper used in the chain.
  2. Build a minimal path map: page -> action -> store write -> API call -> next page.
  3. Mark every branch point explicitly:
    • backend result branches such as 100701 / 100702
    • user choice branches such as confirm / cancel
    • resume vs new-flow initialization
    • success vs failure of follow-up transition APIs

Track Canonical Fields

List the few fields whose semantics must stay stable across the flow. Typical examples:

  • trace fields: traceId, orderNo
  • business order fields: orderId, bizId
  • reservation or plan fields: planOrderId
  • identity fields: name, cert number, validity dates, OCR outputs
  • process control fields: processId, processType, preType, sysId

For each key field, record:

  • source: where the value is first produced
  • persistence: where it is written into store/session/local cache
  • consumers: which later APIs/pages read it
  • required meaning: what the downstream code assumes the field represents

If one field temporarily holds another concept, flag it. Do not accept "it gets corrected later" unless every intermediate consumer is proven safe.

Check Each Branch

For every branch point, verify these questions in order:

  1. Does the page continue, block, or only show a message?
  2. Does any store state change before the branch is confirmed?
  3. If the user cancels or the next API fails, will dirty state remain?
  4. Do later pages read from the latest closure variable or from persisted store state?
  5. Are success-only values written only after the success condition is truly satisfied?

Pay special attention to:

  • writing business ids before transition APIs succeed
  • cancel branches that leave persisted intermediate state
  • fallback expressions such as orderId || orderNo
  • one API using the correct local value while later pages still read an old store value

Validate Request Accuracy

For each important API in the flow:

  1. Locate the real payload assembly in code.
  2. Map every critical field to its source variable.
  3. Check type and format only from actual values or formatting code, not guesses.
  4. Compare semantically similar fields across APIs to ensure they are not silently collapsed.

When Excel or API docs are involved, compare:

  • field name
  • required/optional status
  • type
  • format
  • constant values
  • whether the value sits in header, query, or body

Judge Minimal-Change Safety

When reviewing a patch, ask:

  1. Did the change fix only the intended semantic bug?
  2. Did it move persistence earlier or later than before?
  3. Did it alter cancel, retry, refresh, resume, or failure paths?
  4. Did it introduce a new rejection/throw path without updating callers?
  5. Does it preserve original control flow for unaffected branches?

Prefer the smallest fix that restores correct field semantics without widening behavior changes.

Report Findings

Findings come first. Order by severity.

Each finding should include:

  • severity
  • exact file and tight line reference
  • branch or scenario that triggers it
  • why the resulting data becomes inaccurate or inconsistent
  • whether the risk is wrong request data, dirty persisted state, or flow-control regression

After findings, give a short flow summary only if it helps explain the issue set.

Output Patterns

Use this skill for outputs such as:

  • code review focused on state consistency
  • end-to-end flow reconstruction
  • branch-by-branch data accuracy audit
  • minimal-change and no-regression review
  • interface field provenance checks across pages and API wrappers
Usage Guidance
This skill appears safe to install for code review use. It will guide the agent to read relevant code and API documentation when asked to audit a workflow, so use it in projects where that level of repository inspection is intended.
Capability Assessment
Purpose & Capability
The stated purpose is reviewing business workflows for branch consistency, field provenance, and request accuracy, and the SKILL.md instructions stay aligned with that purpose.
Instruction Scope
Instructions are limited to code-path tracing, branch checks, API payload validation, and reporting review findings; they do not direct mutation, credential use, exfiltration, or policy bypass.
Install Mechanism
The artifact contains a single markdown skill file with no scripts, dependencies, executable files, or install-time actions beyond skill registration.
Credentials
The skill expects the agent to inspect relevant project code, store writes, API wrappers, and documentation, which is proportionate for a code review workflow but should be invoked only on repositories the user intends to review.
Persistence & Privilege
No persistence, background execution, privilege escalation, network calls, local profile/session access, or credential handling is present in the artifact.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install data-flow-review
  3. After installation, invoke the skill by name or use /data-flow-review
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of flow-data-review. - Enables review of business workflows for branch-state consistency and end-to-end data correctness. - Provides guidelines for tracing code paths, inspecting branch points, and verifying critical field semantics (e.g., traceId, orderId, bizId). - Outlines steps to reconstruct minimal path maps, track canonical fields, and validate API request payloads. - Includes detailed checklists for branch validation and patch safety assessments. - Specifies structured reporting of findings with severity, file references, and flow analysis.
Metadata
Slug data-flow-review
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is data-flow-review?

Review business workflows for branch-state consistency, key field semantics, and end-to-end data correctness. Use when Codex needs to trace a flow, inspect b... It is an AI Agent Skill for Claude Code / OpenClaw, with 40 downloads so far.

How do I install data-flow-review?

Run "/install data-flow-review" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is data-flow-review free?

Yes, data-flow-review is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does data-flow-review support?

data-flow-review is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created data-flow-review?

It is built and maintained by ModeYapu (@modeyapu); the current version is v1.0.0.

💬 Comments