You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Only act on published feedback. Ignore review submissions in GitHub's `PENDING` state and inline
90
+
comments attached to those pending reviews. Do not mark pending review feedback as seen; it should
91
+
be eligible to surface after the reviewer submits the review.
92
+
89
93
It intentionally surfaces Codex reviewer bot feedback (for example comments/reviews from `chatgpt-codex-connector[bot]`) in addition to human reviewer feedback. Most unrelated bot noise should still be ignored.
90
94
For safety, the watcher only auto-surfaces trusted human review authors (for example repo OWNER/MEMBER/COLLABORATOR, plus the authenticated operator) and approved review bots such as Codex.
91
-
On a fresh watcher state file, existing pending review feedback may be surfaced immediately (not only comments that arrive after monitoring starts). This is intentional so already-open review comments are not missed.
95
+
On a fresh watcher state file, existing unaddressed published review feedback may be surfaced immediately (not only comments that arrive after monitoring starts). This is intentional so already-open review comments are not missed.
92
96
93
97
When you agree with a comment and it is actionable:
94
98
95
99
1. Patch code locally.
96
100
2. Commit with `codex: address PR review feedback (#<n>)`.
97
101
3. Push to the PR head branch.
98
-
4. After the push succeeds, mark the associated GitHub review thread/comment as resolved.
102
+
4. After the push succeeds, resolve the associated GitHub review thread only when allowed by the GitHub state mutation policy below.
99
103
5. Resume watching on the new SHA immediately (do not stop after reporting the push).
100
104
6. If monitoring was running in `--watch` mode, restart `--watch` immediately after the push in the same turn; do not wait for the user to ask again.
101
105
102
106
If you disagree or the comment is non-actionable/already addressed, reply once directly on the GitHub comment/thread so the reviewer gets an explicit answer, then continue the watcher loop. Prefix any GitHub reply to a code review comment/thread with `[codex]` so it is clear the response is automated and not from the human user. If the watcher later surfaces your own reply because the authenticated operator is treated as a trusted review author, treat that self-authored item as already handled and do not reply again.
103
107
If a code review comment/thread is already marked as resolved in GitHub, treat it as non-actionable and safely ignore it unless new unresolved follow-up feedback appears.
104
108
109
+
## GitHub State Mutation Policy
110
+
111
+
You can read any PR state you need for monitoring. Writes must comply with this policy.
112
+
113
+
You can push PRs to update the code under review or to force CI re-runs as described above.
114
+
115
+
You can resolve review comment threads from the human who requested babysitting or from the Codex
116
+
review bot. When resolving, leave a comment prefixed with `[from Codex]: ` and explain what changes
117
+
you made and which commit includes them. Don't touch review threads if other humans other than the
118
+
user who requested babysitting have participated.
119
+
120
+
Before making any changes, fetch the PR state yourself instead of relying on the PR watcher script's
121
+
output.
122
+
123
+
Unless explicitly asked, do not:
124
+
125
+
* comment on other humans' review threads, communicate with the user in chat instead
126
+
* resolve review threads from humans other than the user
127
+
* interact with humans other than the user
128
+
* mark PRs as drafts or ready for review
129
+
* close or reopen PRs
130
+
131
+
In general, never act on GitHub in ways that would make it hard to tell whether you or the user did
132
+
something visible to other humans. When in doubt, ask the user for clarification in chat.
Copy file name to clipboardExpand all lines: .codex/skills/codex-pr-body/SKILL.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,6 +19,8 @@ Limit discussion to the _net change_ of the commit. It is generally frowned upon
19
19
20
20
Avoid references to absolute paths on my local disk. When talking about a path that is within the repository, simply use the repo-relative path.
21
21
22
+
Avoid references to confidential information including but not limited to codenames or OpenAI-internal URLs.
23
+
22
24
It is generally helpful to discuss how the change was verified. That said, it is unnecessary to mention things that CI checks automatically, e.g., do not include "ran `just fmt`" as part of the test plan. Though identifying the new tests that were purposely introduced to verify the new behavior introduced by the pull request is often appropriate.
23
25
24
26
Make use of Markdown to format the pull request professionally. Ensure "code things" appear in single backticks when referenced inline. Fenced code blocks are useful when referencing code or showing a shell transcript. Also, make use of GitHub permalinks when citing existing pieces of code that are relevant to the change.
0 commit comments