菜单
Assemble a review-ready PR body and inline comments from the breadcrumbs the implementation loop captured, the ADRs in the touched area, and the originating PRD. Use when the user has finished implementation on a branch and wants to ship for review.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
The FormSG Oracle — an internal assistant for the FormSG team at Open Government Products (Singapore). Use this skill whenever a FormSG team member asks *why* the product behaves a certain way, asks about past decisions, design rationale, architectural trade-offs, or historical context. Triggers include questions like "why do we do X", "when did we decide Y", "what was the reason for Z", "has this been discussed before", "what does the ADR say about", or any question implying institutional memory about FormSG. Always use this skill — not general knowledge — when answering FormSG product history questions, even if you think you already know the answer.
Review the changes since a fixed point (commit, branch, tag, or merge-base) along four independent axes — Standards, Spec, Architecture, and Divergent design — each run as a parallel sub-agent so contexts stay clean, then verified against false positives and reported side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".
Sets up an `## Agent skills` block in AGENTS.md/CLAUDE.md and `docs/agents/` so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, domain doc layout, and review-prep conventions (commit style and breadcrumb schema). Run before first use of `to-issues`, `to-prd`, `tdd`, `improve-codebase-architecture`, `zoom-out`, or `prepare-for-review` — or if those skills appear to be missing context.
Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices. Use when user wants to convert a plan into issues, create implementation tickets, or break down work into issues.
Turn the current conversation context into a PRD and publish it to the project issue tracker. Use when user wants to create a PRD from the current context.
Test-driven development with red-green-refactor loop, including frontend slices verified against a Figma design source via Storybook stories and an agent-browser visual gate. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, asks for test-first development, or wants to implement a UI/component/page from a Figma design.
| name | prepare-for-review |
| description | Assemble a review-ready PR body and inline comments from the breadcrumbs the implementation loop captured, the ADRs in the touched area, and the originating PRD. Use when the user has finished implementation on a branch and wants to ship for review. |
Author-side companion to review. Moves rationale from where it was captured (breadcrumbs, ADRs, PRD) into where reviewers look (PR body, inline comments). Does not generate rationale — empty sources produce omitted sections.
Requires docs/agents/issue-tracker.md and docs/agents/decisions-breadcrumb.md. Run /setup-formsg-ai-skills if missing.
Pin the fixed point — use user-supplied ref, else main. Capture git diff <fixed-point>...HEAD and git log <fixed-point>..HEAD --oneline.
Collect rationale sources
.scratch/<feature>/decisions.md (optional)docs/adr/ files touching paths in the diffdocs/agents/issue-tracker.md, else .scratch/<feature>/prd.md. Ask user if absent.Assemble PR body — follow TEMPLATE.md. Omit any sub-section whose source is empty.
Screenshots (frontend only) — if diff touches frontend files, follow SCREENSHOTS.md.
Build inline comments — one comment per kind: inline breadcrumb: { file, line, body }. Surface malformed entries (missing file/line) to user.
Preview — show assembled body, inline comment list, and push plan. Wait for explicit approval.
Open PR — after approval:
git push -u origin <branch> if no upstream, else git pushgh pr create --title "<title>" --body-file <tmp>gh api repos/{owner}/{repo}/pulls/{n}/comments