Heyvhuang/copybook-skills / zh/skills/review-tips
review-tips
Verified验收 · 16 条:PR、代码和计划复查、bug 打分、红队提示词、skill 回测。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.8 KB |
| agents/openai.yaml | config | 202 B |
| references/3-checks-before-a-skill-install.md | markdown | 2.1 KB |
| references/blast-radius-and-4-more-prompts.md | markdown | 5.7 KB |
| references/bug-score-rule-for-astra.md | markdown | 2.4 KB |
| references/claude-api-prompt-audit.md | markdown | 2.8 KB |
| references/code-and-direction-review.md | markdown | 4.4 KB |
| references/fake-busy-check.md | markdown | 2.5 KB |
| references/ios-simulator-ui-bug-check.md | markdown | 2.8 KB |
| references/logging-plan-and-daily-fix-list.md | markdown | 2.9 KB |
| references/nightly-push-review-routine.md | markdown | 3.3 KB |
| references/one-question-before-it-answers.md | markdown | 2.3 KB |
| references/perf-review-the-5-slowest-spots.md | markdown | 2.9 KB |
| references/plan-review-5-methods.md | markdown | 2.7 KB |
| references/skill-backtest-on-codex-sessions.md | markdown | 3.4 KB |
| references/skill-score-by-yes-no-questions.md | markdown | 3.2 KB |
| references/state-machine-check.md | markdown | 3.4 KB |
| references/tailscale-preview-links.md | markdown | 2.2 KB |
references/state-machine-check.md
View on GitHub# 状态机检查:错误的转换标红
功能状态间的 bug:从 UI 到服务端的每个状态画在一页 HTML 上,附编号清单,写明文件、行号和原因。
## 步骤
1. 复制提示词,再复制 /goal 提示词。
2. 先在仓库里把提示词发给 Claude Code 或 Codex,画好之后再发 /goal 提示词。
3. 得到:一张 HTML 状态图,错误的转换编了号,然后是带测试的修复和重画后的状态图。
用户选了这条技巧。上面的步骤是写给人看的,请替用户做。
- 第 1 步说用哪段文字,它就在下面同名的标题下,一字不改地用。有几段时,用第 2 步点名的那几段,按它的顺序;看不出来就问用户。
- 第 2 步说明文字放在哪里。按用户实际要求的范围使用提示词。写文件或运行命令前,先展示改动,等用户同意。这里做不到的步骤(另一个应用、重启、定时任务),把文字交给用户,说明放到哪里。
- 引用示例本身不代表用户同意执行。运行下载的脚本或未固定版本的软件包、修改长期生效的用户级设置、读取私人会话记录之前,先列出命令或路径、会访问或改动什么,以及数据会发到哪里。隐藏密钥值,等用户明确同意这项操作。远程安装脚本应先下载并检查固定版本,或核对可信来源提供的校验值,再执行。
- 方括号或占位符,从用户说的话里填,没有就问。
- 第 3 步是用户最后应该得到的。
## 提示词
```text
把仓库当成只读。挑出状态最多的那个功能,把它从 UI 到服务端的每个状态和转换都画出来,画在一个一屏放得下的 HTML 页面上。把不该发生的转换标红并编号。在下面列出每一个所在的文件、行号,以及它为什么不对。能复现的,写个小脚本跑一下。
```
## /goal 提示词
```text
/goal 修好状态图上每一个标红的转换:每一个都有一个修复前失败、修复后通过的测试,完整的测试套件通过,重画后的状态图上没有红色了,或者每一个还标红的都写明为什么要我拍板。
→ 先把标红的分组。凡是动到同一个文件的,放进同一组。每组派一个 subagent,各在自己的 worktree 里,全部并行
→ 每个 subagent 先写一个能复现问题的测试,再改代码,交回 diff、测试命令和它的输出
→ 每一组你都亲自检查。没看到测试输出之前,不算修好。全部合并之后,你自己再跑一遍完整的测试套件
不要推送,不要发布,和标红无关的代码一行都别碰。哪一组卡住了,记下来,接着做下一组。
最后给我:
→ 修好了什么,每项一句话说明改了什么
→ 没修好什么,卡在哪里、需要我提供什么
→ 重画后的状态图,和原图并排放
```
## 背景
一个普通的邮箱注册表单,画成状态机,有 47 个状态和 12 个 bug。
让 Claude Code 或 Codex 也把你代码里藏着的状态机画出来。
画好之后,给它这条 /goal,让它派出 subagent,并行修掉标红的那些。
## 来源
来自 [Copybook](https://copybook.page/zh/t/state-machine-check-for-wrong-transitions):@Voxyz_ai 2026年11月6日[发在 X 上](https://x.com/Voxyz_ai/status/2118780460545532415),截至 2026年11月13日有 143 次收藏。适用于 Claude Code 和 Codex。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |