/install data-flow-review
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
- Find the entry page, downstream pages, and every API wrapper used in the chain.
- Build a minimal path map: page -> action -> store write -> API call -> next page.
- 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
- backend result branches such as
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:
- Does the page continue, block, or only show a message?
- Does any store state change before the branch is confirmed?
- If the user cancels or the next API fails, will dirty state remain?
- Do later pages read from the latest closure variable or from persisted store state?
- 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:
- Locate the real payload assembly in code.
- Map every critical field to its source variable.
- Check type and format only from actual values or formatting code, not guesses.
- 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:
- Did the change fix only the intended semantic bug?
- Did it move persistence earlier or later than before?
- Did it alter cancel, retry, refresh, resume, or failure paths?
- Did it introduce a new rejection/throw path without updating callers?
- 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
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install data-flow-review - 安装完成后,直接呼叫该 Skill 的名称或使用
/data-flow-review触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 40 次。
如何安装 data-flow-review?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install data-flow-review」即可一键安装,无需额外配置。
data-flow-review 是免费的吗?
是的,data-flow-review 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
data-flow-review 支持哪些平台?
data-flow-review 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 data-flow-review?
由 ModeYapu(@modeyapu)开发并维护,当前版本 v1.0.0。