@sentry/junior-github 0.30.0 → 0.31.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/skills/github-code/SKILL.md +0 -1
- package/skills/github-code/references/troubleshooting-workarounds.md +2 -2
- package/skills/github-issues/SKILL.md +3 -4
- package/skills/github-issues/references/issue-examples.md +22 -1
- package/skills/github-issues/references/troubleshooting-workarounds.md +1 -1
package/package.json
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: github-code
|
|
3
3
|
description: Clone GitHub repositories, investigate source code, and manage pull requests via GitHub CLI. Use when users ask to inspect implementation details in a repository, clone code, edit files, answer source-code questions from repo evidence, or open/edit/view/merge pull requests. Prefer this skill for repository and code tasks even when the repo concerns Sentry products.
|
|
4
|
-
uses-config: github.repo
|
|
5
4
|
allowed-tools: bash
|
|
6
5
|
---
|
|
7
6
|
|
|
@@ -4,7 +4,7 @@ Use this table to recover quickly while keeping operations deterministic.
|
|
|
4
4
|
|
|
5
5
|
| Symptom | Likely cause | Fix |
|
|
6
6
|
| ------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
7
|
-
| `unknown command "..."` from `gh` | CLI version too old or wrong binary.
|
|
7
|
+
| `unknown command "..."` from `gh` | CLI version too old or wrong binary in the plugin runtime. | Verify `gh --version`; if it is unavailable or too old, report that the GitHub plugin runtime dependency is not available. |
|
|
8
8
|
| `unknown flag: --depth` from `gh repo clone` | `git clone` flags were passed before `--`. | Pass clone flags after `--`, for example `gh repo clone owner/repo -- --depth=1`. |
|
|
9
9
|
| `Missing required option --repo` | Repo not passed and no default was resolved. | Resolve with `jr-rpc config get github.repo`; pass `--repo owner/repo` explicitly when missing. |
|
|
10
10
|
| Command affects or authenticates against the wrong repo | Stale `github.repo` default or authenticated command missing explicit repo. | Pass `--repo owner/repo` for the target repository, or update `github.repo` before retrying. |
|
|
@@ -14,7 +14,7 @@ Use this table to recover quickly while keeping operations deterministic.
|
|
|
14
14
|
| 403 Forbidden | App lacks required permission on repo or install scope is too narrow. | Verify the repo context, then confirm GitHub App permissions and installation scope. |
|
|
15
15
|
| `gh pr create` fails with auth/permission errors or tries to push interactively | The branch was not pushed first, or repo context is wrong. | Push the branch explicitly first, then rerun `gh pr create --repo owner/repo --head BRANCH ...`. |
|
|
16
16
|
| `git blame`, long log history, or old commits are missing after clone | Repo was cloned shallow by design. | Deepen incrementally with `git -C DIRECTORY fetch --depth=N origin`, or `git -C DIRECTORY fetch --unshallow` when full history is required. |
|
|
17
|
-
| `sandbox setup failed (dnf install gh failed ...)` | `gh` package not available
|
|
17
|
+
| `sandbox setup failed (dnf install gh failed ...)` | `gh` package not available from the plugin runtime dependency bootstrap. | Report the plugin runtime bootstrap failure; do not try to repair package installation from the skill workflow. |
|
|
18
18
|
|
|
19
19
|
## Retry guidance
|
|
20
20
|
|
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: github-issues
|
|
3
3
|
description: Create, update, comment on, label, and inspect GitHub issues via GitHub CLI with concise, evidence-backed content. Use when users ask to open, edit, view, close, reopen, or triage GitHub issues — including tracking bugs, features, or tasks. Prefer this skill over generic repository tools for any issue operation.
|
|
4
|
-
uses-config: github.repo
|
|
5
4
|
allowed-tools: bash
|
|
6
5
|
---
|
|
7
6
|
|
|
@@ -55,11 +54,11 @@ Follow [references/research-rules.md](references/research-rules.md) for cross-ty
|
|
|
55
54
|
- Generalize session framing — strip channel references, slash commands, Slack thread IDs, user @mentions, and transcript fragments; replace with the underlying technical problem.
|
|
56
55
|
- Compress source material. Research notes, hypotheses, or transcripts become a short summary + scoped bullets — never paste raw investigation into the body.
|
|
57
56
|
- Do not add desired outcome, expected behavior, or acceptance criteria unless the thread explicitly requests them.
|
|
58
|
-
- When the request originated from a Slack thread or any on-behalf-of context, append a final line `Action taken on behalf of <name>.` using the
|
|
57
|
+
- When the request originated from a Slack thread or any on-behalf-of context, append a final line `Action taken on behalf of <name>.` using the action requester's real name. The action requester is the current `<requester>` or the person who explicitly asked you to create/update the issue, not necessarily the original reporter.
|
|
59
58
|
|
|
60
59
|
**Attribution:**
|
|
61
60
|
|
|
62
|
-
- Mention who raised the issue when clear from the thread.
|
|
61
|
+
- Mention who raised the issue when clear from the thread. If the reporter differs from the action requester, keep them separate with durable body text such as `Reported by Alice.` or `Raised by Alice during incident triage.`
|
|
63
62
|
- Attach screenshots from the thread as image links when present.
|
|
64
63
|
- Include code snippets, related issues, and related PRs only when they materially improve the issue.
|
|
65
64
|
|
|
@@ -68,7 +67,7 @@ Follow [references/research-rules.md](references/research-rules.md) for cross-ty
|
|
|
68
67
|
Before running the `gh` create/edit command, check each gate. If any fails, revise and re-check before executing:
|
|
69
68
|
|
|
70
69
|
- Title length ≤ 60 characters.
|
|
71
|
-
- Delegated-action footer is the last line when applicable, using the
|
|
70
|
+
- Delegated-action footer is the last line when applicable, using the action requester's real name, not the reporter's name unless they are the same person.
|
|
72
71
|
- No session framing remains (channel refs, slash commands, @mentions, Slack thread IDs).
|
|
73
72
|
- Body structure matches complexity — no empty sections, no restated title, no raw research dump.
|
|
74
73
|
|
|
@@ -69,6 +69,26 @@ Good scope — quantified and specific:
|
|
|
69
69
|
>
|
|
70
70
|
> Action taken on behalf of Jane Doe.
|
|
71
71
|
|
|
72
|
+
## Distinct reporter/requester example
|
|
73
|
+
|
|
74
|
+
Bad attribution:
|
|
75
|
+
|
|
76
|
+
> The bot resolved the review thread even though the warning still applies.
|
|
77
|
+
>
|
|
78
|
+
> Action taken on behalf of Bojan Oro.
|
|
79
|
+
|
|
80
|
+
Good attribution:
|
|
81
|
+
|
|
82
|
+
> Warden can resolve its own review thread even when the underlying warning still appears valid and the PR remains blocked.
|
|
83
|
+
>
|
|
84
|
+
> Reported by Bojan Oro.
|
|
85
|
+
>
|
|
86
|
+
> - Observed on a PR where Warden left a review comment about a missing backport
|
|
87
|
+
> - The review thread was later marked resolved by the bot
|
|
88
|
+
> - The PR still showed a blocking warning
|
|
89
|
+
>
|
|
90
|
+
> Action taken on behalf of David Cramer.
|
|
91
|
+
|
|
72
92
|
## Feature example
|
|
73
93
|
|
|
74
94
|
Bad framing:
|
|
@@ -111,5 +131,6 @@ Good framing — current state, gap, options:
|
|
|
111
131
|
- Confident fix claims without root-cause evidence
|
|
112
132
|
- Speculative detail mixed into verified facts
|
|
113
133
|
- Dumping a list of URLs without inline context
|
|
114
|
-
- Session-specific content (
|
|
134
|
+
- Session-specific content (slash commands, channel references, raw transcript framing, or unrelated user chatter)
|
|
135
|
+
- Conflating reporter and action requester when they differ
|
|
115
136
|
- Missing delegated attribution footer on user-requested issue creation
|
|
@@ -4,7 +4,7 @@ Use this table to recover quickly while keeping operations deterministic.
|
|
|
4
4
|
|
|
5
5
|
| Symptom | Likely cause | Fix |
|
|
6
6
|
| ------------------------------------------------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
|
|
7
|
-
| `unknown command "issue"` from `gh` | CLI version too old or wrong binary.
|
|
7
|
+
| `unknown command "issue"` from `gh` | CLI version too old or wrong binary in the plugin runtime. | Verify `gh --version`; if it is unavailable or too old, report that the GitHub plugin runtime dependency is not available. |
|
|
8
8
|
| `Missing required option --repo` | Repo not passed and no default was resolved. | Resolve with `jr-rpc config get github.repo`; pass `--repo owner/repo` explicitly when missing. |
|
|
9
9
|
| Command affects or authenticates against the wrong repo | Stale `github.repo` default or authenticated command missing explicit repo. | Pass `--repo owner/repo` for the target repository, or update `github.repo` before retrying. |
|
|
10
10
|
| `GraphQL: Could not resolve to a Repository` | Repo slug is wrong or inaccessible. | Validate `owner/repo` and confirm app installation on target repository. |
|