Skip to content

docs: Update skill guidance for Round-7 pause-point, screenshot, and simulate-keyboard outcomes#1925

Merged
hatayama merged 2 commits into
feature/round7-pause-point-improvementsfrom
feature/round7-skill-guidance
Jul 21, 2026
Merged

docs: Update skill guidance for Round-7 pause-point, screenshot, and simulate-keyboard outcomes#1925
hatayama merged 2 commits into
feature/round7-pause-point-improvementsfrom
feature/round7-skill-guidance

Conversation

@hatayama

@hatayama hatayama commented Jul 21, 2026

Copy link
Copy Markdown
Owner

Summary

Round-7 verification feedback (To-Do 13/14) showed agents losing time to guidance gaps rather than tool defects. This PR updates the source skill definitions and regenerates the .claude/ / .agents/ copies. Docs only — no code changes.

  • pause-point / Quick Check Template: rewritten around --trigger (feat: Add --trigger to await-pause-point for one-command verification #1920). One foreground command arms, fires the input in-process after arm confirmation, and waits — replacing the backgrounded-await sequence and its arm-vs-input race caveats. Split-step fallback retained for non-single-command triggers.
  • pause-point / Fast-Progressing Games: documents the residual race when a command round-trip exceeds the game's natural tick interval, and the remedy of temporarily rewriting the tick-interval field via execute-dynamic-code.
  • pause-point / Reading CapturedVariables: physics-callback Rigidbody values can be mid-solver intermediates; a differing post-hoc execute-dynamic-code read is the solver finishing, not a capture bug.
  • pause-point / Marker Types: the existing-instance physics-callback note now matches the PR fix: Physics pause points that miss a pre-existing GameObject now log diagnostics for future investigation #1922 retraction — environment-dependent, does not reproduce on demand, and HitCount=0 needs fresh-contact evidence (a stale pre-arm counter proves nothing) before it is treated as the miss.
  • screenshot: always use the response ImagePath; the output directory accumulates captures, so ls -t can silently pick a stale file.
  • simulate-keyboard: a pause landing during the Press duration wait returns promptly with InterruptedByPausePoint: true, with pause priority over a satisfied duration (fix: Detect pause-point interruption during Press/KeyDown observation wait #1919) — documented as the pause reporting in, not a delivery failure.

Verification

  • dist/darwin-arm64/uloop skills install --claude --agents regenerated; diff confirms the tracked copies match the sources byte-for-byte.
  • Wording cross-checked against the merged implementations (pause_point_trigger.go for --trigger constraints, PressLifetimeIterationResolver.ResolvePostWaitOutcome for pause priority).

Part of Round-7 (To-Do 13–14). Base: feature/round7-pause-point-improvements.

Review in cubic

…shot, and simulate-keyboard

The Round-7 verification feedback showed agents losing time to guidance
gaps rather than tool defects, so each note captures a contract the tools
cannot express in their responses alone:

- Rewrite the pause-point Quick Check Template around --trigger (added in
  round 7): one foreground command replaces the backgrounded-await dance,
  removing the arm-vs-input race the old template had to explain around.
- Fast-Progressing Games: document the residual race when a command
  round-trip exceeds the game's own tick interval, and the
  rewrite-the-interval-field remedy that removes the race outright.
- Reading CapturedVariables: physics-callback Rigidbody values can be
  mid-solver intermediates; a differing post-hoc read is not a capture bug.
- Physics message methods: require fresh-contact evidence before treating
  HitCount=0 as the existing-instance miss (a stale pre-arm counter proves
  nothing), matching the retraction in PR #1922.
- Screenshot: always use the response ImagePath; the output directory
  accumulates captures, so ls -t can pick a stale file.
- simulate-keyboard: a pause landing during the Press duration wait now
  reports InterruptedByPausePoint=true with pause priority over a
  satisfied duration (PR #1919) - document it as a report, not a failure.

Generated .claude/.agents copies regenerated via uloop skills install.
@coderabbitai

coderabbitai Bot commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

@hatayama, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 5 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 19bfcf0d-bf24-45c6-b201-d4321f59fc2e

📥 Commits

Reviewing files that changed from the base of the PR and between de474f4 and 63fbe9f.

📒 Files selected for processing (9)
  • .agents/skills/uloop-pause-point/SKILL.md
  • .agents/skills/uloop-screenshot/SKILL.md
  • .agents/skills/uloop-simulate-keyboard/SKILL.md
  • .claude/skills/uloop-pause-point/SKILL.md
  • .claude/skills/uloop-screenshot/SKILL.md
  • .claude/skills/uloop-simulate-keyboard/SKILL.md
  • Packages/src/Editor/CliOnlyTools~/PausePoint/Skill/SKILL.md
  • Packages/src/Editor/FirstPartyTools/Screenshot/Skill/SKILL.md
  • Packages/src/Editor/FirstPartyTools/SimulateKeyboard/Skill/SKILL.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/round7-skill-guidance

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

The sentence prevents a wasteful follow-up await-pause-point call after a
hit returned by enable-pause-point --await; the --trigger rewrite dropped
it unintentionally.
@hatayama
hatayama merged commit 1ed1e64 into feature/round7-pause-point-improvements Jul 21, 2026
1 of 2 checks passed
@hatayama
hatayama deleted the feature/round7-skill-guidance branch July 21, 2026 15:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant