AGENT SKILL

issue-create

Files a new GitHub issue: searches for duplicates, picks focused vs umbrella scope, applies real labels, and previews before posting. Use when the user asks to file, open, or track an issue, and when another workflow needs to record deferred work, a bug found mid-task, or a follow-up as an issue.

License 许可
Apache-2.0
最近更新
2026-11-13
Stars
★ 0
Forks
1

01 前言 Front Matter

name
issue-create
description
Files a new GitHub issue: searches for duplicates, picks focused vs umbrella scope, applies real labels, and previews before posting. Use when the user asks to file, open, or track an issue, and when another workflow needs to record deferred work, a bug found mid-task, or a follow-up as an issue.
allowed-tools
Bash(gh issue *), Bash(gh search *), Bash(gh label list*), Read

02 资源文件 1

03 SKILL.md 正文

Issue Create

File one issue without fragmenting a discussion that already exists. The user sees the title, body, and labels before anything is posted.

1. Search for duplicates

gh search issues "<keywords>" --repo <owner>/<repo>
gh issue list --repo <owner>/<repo> --search "<keywords>" --state all

Read each candidate's body and comments; a title alone misleads. Search by topic, not by the title you were about to write: the same work is often filed under a different framing (an issue saying "the standard is documented but unenforced" can duplicate one saying "set up the testing stack"). Try two or three phrasings of the underlying need.

  • Same work: comment on it with your context and a cross-link instead, after showing the user that comment, and stop. Fragmenting discussion across near-duplicates costs more than over-linking.
  • Adjacent but distinct: file the new issue and cross-link both directions.
  • Unclear: show both to the user and ask.

When the caller names an issue as a known source (an issue being split, say), it is adjacent by definition: link it, and file.

Done when every candidate is classed as same, adjacent, or unrelated.

2. Decide scope

File focused by default: one fix, one file or tight area, one PR closes it. File an umbrella, tracked with checkboxes, when the work spans three or more files or domains, you expect two or more PRs against it, or triage needs a single anchor for related conversations. When in doubt, file focused: splitting an umbrella later is cheap, and so is merging focused issues (the issue-restructure skill, which the user runs).

Done when you can say which shape this is and why.

3. Pick labels

gh label list --repo <owner>/<repo>

Apply kind (bug, enhancement, chore), area, and priority (p0–p3) from labels that exist. When none fits, file without it and add a line to the body: "No area:* label exists yet; suggest creating one." Leave gh label create to the maintainer, because the label set is a repo-config decision.

Done when every label you plan to apply appears in gh label list.

4. Draft and preview

Write the body: context, current behaviour, expected behaviour, file:line references, and cross-links to related issues and PRs. For each adjacent issue from step 1, draft the one-line comment that will link it back to the new issue. Show the user the title, body, labels, and those link-back comments.

Done when the user confirms the draft.

5. File

gh issue create --repo <owner>/<repo> --title "..." --body "..." --label "..."
gh issue comment <adjacent#> --repo <owner>/<repo> --body "Related: #<new>"   # per adjacent issue

Done when you've printed the new issue's URL, and every adjacent issue from step 1 links back to it.

Related

  • issue-close — close as resolved, superseded, or duplicate.
  • issue-update — edit the body or labels, comment, reopen.
  • issue-restructure — split one issue into many, or merge many into one.
  • harness-issue — file upstream against harness-kit specifically.

04 同仓库更多 Skills

dougborg
dougborg/harness-kit

teach

Teach yourself a topic over several sessions, with lessons, references, and a record of what you've learned.

教师与教育
★ 0
dougborg
dougborg/harness-kit

svg-logo-designer

Generate SVG logos with multiple concepts, layouts, and color variations.

图像与多媒体
★ 0
dougborg
dougborg/harness-kit

documentation-writer

Writes and revises human-facing documentation — READMEs, contributor and setup guides, reference pages, architecture notes, CLAUDE.md, and changelog entries. Covers picking the right document type for the question being asked, structuring for skimming, writing examples that actually run, and keeping docs from going stale. Use when creating or rewriting docs, when a README has drifted from the code, or when deciding where a piece of information belongs. For SKILL.md and agent files, use /skill-writer instead.

内容创作者写作与文案
★ 0
dougborg
dougborg/harness-kit

adhd-mode

Shapes every response for a reader with ADHD: the next action first, numbered steps, progress restated each turn, tangents held back, concrete time estimates, wins made visible. Stays on for the rest of the session until the reader says "stop adhd mode". On Claude Code, the harness-kit:adhd output style does the same without invoking this skill.

★ 0
dougborg
dougborg/harness-kit

wait-what

That last message didn't land: re-explain it with the missing context.

★ 0
dougborg
dougborg/harness-kit

to-questionnaire

Turn a decision you can't make alone into a questionnaire for the one person who can answer it, filled in async or together in a meeting.

★ 0