Changelog 5755cfftree, with Claude Opus 5.5
solve-issues: close and comment through GitHub itself
Commits carry Fixes #n (Refs #n for partial fixes); resolved issues are closed at once with gh issue close --comment, disproved ones as not planned, unresolved ones get a gh issue comment and stay open.
2 files of code, design or docs +38 −12 lines
Code, design and documents 2 files
.claude/skills/solve-issues/SKILL.md +5 −3
@@ -13,5 +13,7 @@ this skill only points to it. country or the same kind of mistake. 3. For each issue: read the cited source yourself, decide what is confirmed, fix the data, run the - checks, and commit only your own files with `(#<number>)` in the message. -4. Comment on and close issues only when the user asked for it; otherwise report the drafted - comments. Never push unless asked. + checks, and commit only your own files with `Fixes #<number>` in the message body (`Refs #<number>` + for a partial fix). +4. Answer on GitHub with `gh`: close a resolved issue with `gh issue close <n> --reason completed + --comment …`, a disproved one with `--reason "not planned"` and the source, and leave an + unresolved one open with `gh issue comment`. Never push unless asked.
docs/SOLVE-ISSUES.md +33 −9
@@ -72,13 +72,37 @@ in `scripts/profile-claims.test.mjs`. ## 5. Commit, answer, close -- Commit per issue, or per group, with the issue number in the message: - `Czechia: name serum for the 2 ng/mL driving limit (#268)`. Only your own files. -- For a batch of five or more, write `docs/research/bug-review-<date>.md`: a table of issue, +Use GitHub's own mechanisms, not notes elsewhere: a closing keyword in the commit, and the +issue's own comment thread and close action through `gh`. + +- **Commit** per issue, or per group, with a closing keyword and the issue number in the message + body, one line per issue, so GitHub links the commit to the issue and closes it again when the + commit reaches `main`: + + ```text + Czechia: name serum for the 2 ng/mL driving limit + + Fixes #268 + ``` + + Use `Fixes #n` only for an issue the commit resolves; for a partial fix write `Refs #n`. Commit + only your own files. +- **Comment and close at once**, once the fix is committed: the commit is not pushed yet, so the + keyword alone would leave the issue open. Write the comment to a file and pass it to `gh`: + + ```bash + gh issue close 268 --reason completed --comment "$(cat /path/to/comment-268.md)" + ``` + + The comment says in a few lines what changed, which sources were read (with links), what was not + confirmed and why, and the commit hash, and that the fix is committed but not yet pushed or + deployed, unless it is. +- **Resolved** (confirmed, or partly confirmed with the rest explained): close with + `--reason completed`. +- **Disproved:** change nothing in the data, and close with `--reason "not planned"` and a comment + that quotes the source that disproves the report. +- **Not resolved** (a source could not be opened, the law is unclear, or the fix needs a decision + from the maintainer): leave the issue open and add a comment with what was checked and what is + still needed: `gh issue comment 268 --body-file /path/to/comment-268.md`. +- For a batch of five or more, also write `docs/research/bug-review-<date>.md`: a table of issue, profile and resolution (including what was disproved), and the sources read with their limits. -- Answer each issue with a short comment: what changed, which sources were read, what was not - confirmed and why, and the commit hash. Say that the fix is committed locally and not yet pushed - or deployed, unless it is. -- **Comment and close only when the user asked you to** in this request (`gh issue comment`, - `gh issue close --reason completed`). Otherwise list the drafted comments in your report and ask. - Close a disproved report with `--reason "not planned"` and the source that disproves it. - Never push unless the user asks.