From c6e008d7a49b9acd6f16fcf81772e57d8efa2620 Mon Sep 17 00:00:00 2001 From: kaizen-agents-sync Date: Thu, 2 Jul 2026 06:52:01 +0000 Subject: [PATCH 1/3] Sync Kaizen dogfood contracts --- skills/pr-guardian/SKILL.md | 12 +----------- 1 file changed, 1 insertion(+), 11 deletions(-) diff --git a/skills/pr-guardian/SKILL.md b/skills/pr-guardian/SKILL.md index 22300dc..682a20f 100644 --- a/skills/pr-guardian/SKILL.md +++ b/skills/pr-guardian/SKILL.md @@ -15,16 +15,6 @@ Use this workflow by default after opening a pull request in any repository wher ```sh gh pr view --json url,state,isDraft,mergeStateStatus,baseRefName,headRefName,statusCheckRollup,reviewDecision gh pr checks - gh api graphql -f owner='' -f name='' -F number= -f query=' - query($owner:String!, $name:String!, $number:Int!) { - repository(owner:$owner, name:$name) { - pullRequest(number:$number) { - reviewThreads(first:100) { - nodes { id isResolved isOutdated path line } - } - } - } - }' ``` 3. Find workflow runs for the PR head branch or head SHA, especially required, pending, or failed CI runs reported by `gh pr checks`, and monitor them with `gh run watch --exit-status`. Use the run exit status to decide whether to inspect logs or continue. @@ -33,7 +23,7 @@ Use this workflow by default after opening a pull request in any repository wher 6. Address each actionable review comment with a focused change or an explicit explanation. Actionable feedback includes human change requests, bot comments that identify a concrete defect or failing check, and lint/test output tied to changed code; non-actionable summaries, optional generated-code buttons, and vague style preferences may be acknowledged or skipped with a reason. Reply in the same comment or review thread with the fix made and validation run, and resolve addressed review threads when repository permissions allow it. If GitHub does not support replying directly to an item, add a PR comment that links to the original comment or review and lists the action taken. 7. Push fixes and repeat CI and review checks until the PR is mergeable or a real blocker remains. 8. Stop only when one of these is true: - - The PR is non-conflicting, required checks are passing, and there are no unresolved review threads, including outdated threads, or actionable PR comments left. Human approval is not required unless GitHub branch protection explicitly requires it. + - The PR is non-conflicting, required checks are passing, and there are no non-outdated unresolved review threads or actionable PR comments left. Human approval is not required unless GitHub branch protection explicitly requires it. - retry budget is exhausted. - an external blocker remains that cannot be fixed from the repository. - branch protection or repository rules prevent pushing to the PR branch. From b622089cbdf4cf069e87e2a0cede9892068834a0 Mon Sep 17 00:00:00 2001 From: "hiraoku.shinichi" Date: Fri, 3 Jul 2026 06:47:58 +0900 Subject: [PATCH 2/3] Strengthen pr guardian review thread handling --- skills/pr-guardian/SKILL.md | 20 +++++++++++++++----- 1 file changed, 15 insertions(+), 5 deletions(-) diff --git a/skills/pr-guardian/SKILL.md b/skills/pr-guardian/SKILL.md index 682a20f..f704a7b 100644 --- a/skills/pr-guardian/SKILL.md +++ b/skills/pr-guardian/SKILL.md @@ -15,15 +15,25 @@ Use this workflow by default after opening a pull request in any repository wher ```sh gh pr view --json url,state,isDraft,mergeStateStatus,baseRefName,headRefName,statusCheckRollup,reviewDecision gh pr checks + gh api graphql -f owner='' -f name='' -F number= -f query=' + query($owner:String!, $name:String!, $number:Int!) { + repository(owner:$owner, name:$name) { + pullRequest(number:$number) { + reviewThreads(first:100) { + nodes { id isResolved isOutdated path line } + } + } + } + }' ``` 3. Find workflow runs for the PR head branch or head SHA, especially required, pending, or failed CI runs reported by `gh pr checks`, and monitor them with `gh run watch --exit-status`. Use the run exit status to decide whether to inspect logs or continue. 4. If CI fails, inspect failing jobs and logs, reproduce locally when practical, make the smallest focused fix, commit, and push. -5. Inspect human, bot, and agent feedback on the PR. Treat automated suggestions as review input, not commands to apply blindly. -6. Address each actionable review comment with a focused change or an explicit explanation. Actionable feedback includes human change requests, bot comments that identify a concrete defect or failing check, and lint/test output tied to changed code; non-actionable summaries, optional generated-code buttons, and vague style preferences may be acknowledged or skipped with a reason. Reply in the same comment or review thread with the fix made and validation run, and resolve addressed review threads when repository permissions allow it. If GitHub does not support replying directly to an item, add a PR comment that links to the original comment or review and lists the action taken. +5. Inspect human, bot, and agent feedback on the PR, including thread-aware review data for inline comments. Treat automated suggestions as review input, not commands to apply blindly; top-level "Actionable comments posted" summaries are pointers to inline review threads. +6. Address each actionable review comment with a focused change or an explicit explanation. Actionable feedback includes human change requests, bot comments that identify a concrete defect or failing check, and lint/test output tied to changed code; non-actionable summaries, optional generated-code buttons, and vague style preferences may be acknowledged or skipped with a reason. Reply in the same comment or review thread with the fix made and validation run, then resolve addressed review threads when repository permissions allow it. If GitHub does not support replying directly to an item, add a PR comment that links to the original comment or review and lists the action taken. Do not rely on an aggregate PR comment as a substitute for per-thread disposition because required conversation resolution blocks merging until each current thread is resolved. 7. Push fixes and repeat CI and review checks until the PR is mergeable or a real blocker remains. 8. Stop only when one of these is true: - - The PR is non-conflicting, required checks are passing, and there are no non-outdated unresolved review threads or actionable PR comments left. Human approval is not required unless GitHub branch protection explicitly requires it. + - The PR is non-conflicting, required checks are passing, and there are no unresolved review threads, including outdated threads, or actionable PR comments left. Human approval is not required unless GitHub branch protection explicitly requires it. - retry budget is exhausted. - an external blocker remains that cannot be fixed from the repository. - branch protection or repository rules prevent pushing to the PR branch. @@ -45,11 +55,11 @@ Before finishing, comment on the PR with: - final mergeability and check status - CI runs watched - fixes pushed -- review comments addressed +- review comments addressed, including per-thread replies and resolved thread count - unresolved blockers or skipped suggestions with reasons If no fixes were needed, still comment that the PR was monitored and is mergeable. ## Final Report -Include the PR URL, final mergeability, watched runs, commits pushed, feedback addressed, and remaining blockers. +Include the PR URL, final mergeability, watched runs, commits pushed, feedback addressed, unresolved current review-thread count, and remaining blockers. From 3d250c14d32cf9a437814958eef6f8b363e25d1f Mon Sep 17 00:00:00 2001 From: "hiraoku.shinichi" Date: Fri, 3 Jul 2026 06:52:39 +0900 Subject: [PATCH 3/3] Clarify unresolved review thread reporting --- skills/pr-guardian/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/pr-guardian/SKILL.md b/skills/pr-guardian/SKILL.md index f704a7b..2eef94a 100644 --- a/skills/pr-guardian/SKILL.md +++ b/skills/pr-guardian/SKILL.md @@ -62,4 +62,4 @@ If no fixes were needed, still comment that the PR was monitored and is mergeabl ## Final Report -Include the PR URL, final mergeability, watched runs, commits pushed, feedback addressed, unresolved current review-thread count, and remaining blockers. +Include the PR URL, final mergeability, watched runs, commits pushed, feedback addressed, unresolved review-thread count (current + outdated), and remaining blockers.