oopsla5xx/oops-skills

review-pr

Review PR diff against the spec before shipping — check spec compliance, conventions, scope, required security checklist, and test coverage. Outputs a structured verdict (APPROVE / REQUEST CHANGES / COMMENT). Run after self-check, before Phase 4 ship.

原文语言：英语

debug

Systematic bug investigation workflow. Tool-agnostic but MCP-aware — test cases and MCP tools are evidence sources, not prerequisites. Applies to any stack (frontend, backend, CLI, mobile, distributed systems).

原文语言：英语

clarify-scope

Decide whether to ask before coding or proceed with stated assumptions. Small/clear tasks → do it. Large/ambiguous tasks → state assumptions and ask at most 1 critical question. Run at the start of any task.

原文语言：英语

create-pr-description

Generate a pull request description by filling in the .github/PULL_REQUEST_TEMPLATE.md from spec, git diff, and commit history. Outputs ready-to-use text or creates PR via gh CLI. Run as part of Phase 4 ship.

原文语言：英语

implement-tdd

Implement each step from the plan using TDD — write failing test first, then minimal code to pass, then refactor. Run for each unchecked step in the Plan section of .ai/tasks/<name>.md.

原文语言：英语

plan-tasks

Break a spec file into ordered, concrete implementation steps with done criteria. Appends a Plan section to the existing .ai/tasks/<name>.md. Run after write-spec, before coding.

原文语言：英语

setup-ai-context

Bootstrap .ai/ context files — auto-detect stack and fill commands.md, architecture.md, conventions.md instead of filling TODO placeholders manually. Run when setting up oops-skills template in a new project.

原文语言：英语

ship

Final ship step — push branch, open PR on GitHub, update status.md, clean up task files. Run after review-pr APPROVE and create-pr-description.

原文语言：英语

sync-ai-context

Refresh stale .ai/ context files before starting a task — detect which of commands.md, architecture.md, conventions.md are outdated and patch only those sections. Run at the start of each task session.

原文语言：英语

write-spec

Convert clarify-scope discussion into a structured spec file at .ai/tasks/<name>.md. Run after clarify-scope resolves assumptions and scope. Captures decisions before they're lost in conversation history.

原文语言：英语

write-test-scenarios

Generate manual test scenarios (UC/TC) from the spec file after implementation — use cases and step-by-step test cases for human testers to verify the feature by hand. Output saved to .ai/tasks/<name>-manual-tests.md.

原文语言：英语