flow-code-review
Review a branch or diff against Standards and Spec, using independent assistance when risk warrants it, and rank actionable findings.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- flow-code-review
- description
- Review a branch or diff against Standards and Spec, using independent assistance when risk warrants it, and rank actionable findings.
03 SKILL.md 正文
Flow Code Review
Review the diff along two axes:
- Standards: repository instructions, documented conventions, security, correctness, maintainability, and relevant smell heuristics.
- Spec: requested behavior, missing or partial requirements, unrequested scope, and behavior that looks implemented incorrectly.
For ordinary changes, Astra owns both inspections and the integrated judgment. When independent reviewers are selected below, keep their packets blind.
1. Pin the fixed point
Use the fixed point supplied by the user. Otherwise infer it from repository evidence:
- current pull request base;
- configured upstream;
- remote default branch;
origin/develop, thenorigin/main, thenorigin/master, when exactly one is sensible.
Ask only when the evidence leaves materially different comparisons. Confirm the ref resolves and the three-dot diff is non-empty before starting review lanes.
2. Identify sources
Find the spec from issue references, a user-supplied path, or matching files under docs/, specs/, or .scratch/. Follow docs/agents/issue-tracker.md when external tracker data is required. If there is no spec, skip that lane and say so.
Find applicable AGENTS.md, CONTRIBUTING.md, coding standards, domain docs, and validation rules. Repo rules override generic heuristics.
The Standards lane may flag these only as judgment calls when repo policy does not endorse them:
- mysterious names;
- duplicated code;
- feature envy;
- data clumps;
- primitive obsession;
- repeated switches;
- shotgun surgery;
- divergent change;
- speculative generality;
- message chains;
- middle men;
- refused bequests.
Skip anything deterministic tooling already enforces unless the tool is absent or its result is failing.
3. Review both axes with proportional isolation
Inside a Git repository, load coding-orchestration. Astra reviews both axes directly for ordinary changes. Use one independent Astra review with separate Standards and Spec notes when security, migrations, cross-cutting changes, or a user request justify independent review. Use two blind reviewers only when their independent investigations materially reduce risk. Resolve providers through the installed roster.
Give each lane only the fixed diff packet, commit list, and its own sources. Do not give either lane the other report.
Standards brief:
Cite actionable correctness, regression, security, maintainability, or documented-standard problems by tight file and line. Distinguish hard violations from smell judgments. Omit style-only findings already enforced by tooling. Return under 400 words.
Spec brief:
Cite missing or partial requirements, scope creep, and incorrectly implemented requested behavior by tight file and line plus the supporting spec text. Return under 400 words.
If delegation is not useful or unavailable, run the passes sequentially with separate evidence notes.
4. Integrate and verify
The parent must:
- Validate each candidate against the actual diff and source.
- Merge duplicates and resolve contradictions while retaining the producing axis.
- Rank findings by user impact and regression risk.
- Put actionable findings first with tight file and line references.
- Inspect the real command, log, route, or runtime behavior behind any material green-check claim.
- End with a short Standards/Spec status and residual verification gaps.
Do not edit product code unless the user asked to address findings. If nothing actionable remains, say so plainly.
Review document
Load show-me and working-backwards/report-reference.md for the shared visual
presentation; use pr-lens for a useful map of the reviewed change.
Generate a review technical document from the integrated findings and link
it in the final message, unless the user explicitly opts out:
development-system document --input packet.json --home HOME --json
Use the current diff evidence and publication boundaries; state partial or
blocked work as such instead of claiming completeness. The command writes
canonical Markdown and shared-reader HTML under
HOME/.development-system/private/documents and grants no workflow authority,
so this already requested local document needs no extra approvals.
04 同仓库更多 Skills
working-backwards
Define a software feature through PRFAQ and staged documents when the user requests working backwards before coding.
flow-implement
Implement a requested software change through verification, corrections, and its authorized delivery endpoint.
development-steward
Run the scheduled, read-only weekly maintenance review for the six explicitly opted-in repositories and prepare one concise private report for Check-in.
grill-with-docs
Run one recoverable interview for functional, visual, or mixed software grills; reuse equivalent answers and offer the shared HTML questionnaire.
global-agent-guardrails
Install, audit, test, or update the Development System's global destructive-command guard for Codex, Claude Code and T3 Code. Use when configuring agent safety hooks or investigating whether dangerous shell operations are blocked.
impeccable
Design or refine frontend UI using project context and a focused design playbook; also handles visual critique and polish.