AGENT SKILL

ticket

Capture a brain-dump as a well-formed work item - verb-first title, acceptance criteria, file paths when known, an out-of-scope line. Files a GitHub issue in tickets mode or appends a numbered PLAN.md task in document mode; unknowns are marked TBD, never invented. Use when the user brain-dumps an idea, bug, or task to capture for later, or asks to ticket, file, or note something as work.

License 许可
MIT
最近更新
2026-09-28
Stars
★ 2
Forks
0

01 前言 Front Matter

name
ticket
description
Capture a brain-dump as a well-formed work item - verb-first title, acceptance criteria, file paths when known, an out-of-scope line. Files a GitHub issue in tickets mode or appends a numbered PLAN.md task in document mode; unknowns are marked TBD, never invented. Use when the user brain-dumps an idea, bug, or task to capture for later, or asks to ticket, file, or note something as work.
argument-hint
<brain-dump>

03 SKILL.md 正文

/ticket — capture without friction, file without slop

The frictionless entry point that keeps ideas from routing around the system. A thought arrives half-formed; it leaves as a work item the next session can pick up cold — or it honestly wears a TBD.

Adjacent skills: /do (does the work; /ticket only captures it) · /triage (grooms the many existing items; /ticket files one new one).

<!-- acstack:runtime --> Run before the skill's steps — per invocation, not per session (4.36); failures degrade to markdown:

link="$(readlink "$HOME/.claude/skills/health" 2>/dev/null || true)"   # empty = not symlinked
pack="$(dirname "$(dirname "$link")")"   # NEVER trust this unless $link was non-empty
if [ "${link#/}" != "$link" ] && [ -x "$pack/bin/acstack-config" ] && ! "$pack/bin/acstack-config" runtime | grep -q '=off'; then
  "$pack/bin/acstack-config" || true          # resolved keys, with sources
  "$pack/bin/acstack-update-check" || true    # ≤1 fetch/day; silent ONLY if already checked today
  "$pack/bin/acstack-recall" || true          # LEARNINGS.md + bug-class names, capped 3KB
else
  echo "runtime off — proceeding without recall/update-check"
fi

<!-- /acstack:runtime -->

<!-- acstack:principles -->

Operating principles

  • Be direct. Push back in writing when the plan or the user is wrong. No sycophancy.
  • Never delete a decision. Supersede it: ~~old~~ → **Verdict (YYYY-MM-DD):** new call — reason.
  • Never fix, tune, or delete a test or eval case to raise a score. Log the miss honestly and leave the case unchanged.
  • Name exact things: regex patterns, function signatures, model names, before → after numbers. Never "fixed bugs".
  • Attribution: follow the project's attribution setting (default none) — no AI-tool mentions in generated docs, no attribution trailers in commits or PRs. Commit with explicit -m/-F messages only.
  • Config: read .claude/acstack.md at the project root (fall back to ~/.claude/acstack.md) before acting. ## Settings keys override pack defaults; a ## <skill-name> section overrides both. Unknown keys and sections are ignored.
  • Docs: BRIEF.md (frozen seed) / PLAN.md (living plan) / JOURNAL.md (rolling journal). If the repo uses legacy names (PLANNING_PROMPT.md / PLANNING.md / STATUS.md), use those instead — never create both.
  • Recall: if LEARNINGS.md exists at the project root, read it before starting.
  • Conduct: follow the acstack-conduct block in this repo's AGENTS.md — the word is the mode; the user sets the pace.
  • Hackathon lane: if the project's AGENTS.md carries the acstack:hackathon-lane block, only /do changes the repository during the event. Any other skill that would write a tracked file, commit or push says what it would have done and stops; a change that is not a task goes through the lane's operator route. <!-- /acstack:principles -->

One document set. Resolve exactly ONE BRIEF/PLAN/JOURNAL set and name its path in the report's scope line. If more than one candidate set exists — a monorepo, nested products, an apps/* tree each with its own docs — list the candidates and STOP. Never pick one silently: a confident answer about the wrong product is worse than no answer (conduct rule 8).

The bar

Every filed item has:

  • Verb-first title — fix scheme-name matching for hyphenated funds, not scheme names.
  • Acceptance criteria — runnable where possible; observable always.
  • File paths — when known or cheaply inferable from the dump.
  • Out-of-scope line — the adjacent thing this item deliberately does NOT cover; the line that prevents scope osmosis later.

What the dump doesn't say and the repo can't cheaply tell you is marked explicitly — Acceptance: TBD — needs <what> — never invented. A wrong guessed acceptance is worse than an honest TBD: it fails silently at /do time.

At most ONE round of clarifying questions, and only when the item would otherwise be unfileable (no discernible action at all). Friction is the enemy here: a captured-but-imperfect item beats a perfect item the user gave up on filing.

Tickets mode (tracking: tickets)

Preconditions — gh installed, gh auth status succeeding, and a GitHub remote present. Any failure names WHICH one failed and offers document mode; never guess. Then gh issue create:

  • Body follows .github/ISSUE_TEMPLATE/task.md (acceptance / files / out-of-scope sections).
  • Best-fit label from the standard set (bug / feature / chore); items with TBD acceptance also get needs-acceptance.
  • Milestone: the current one, unless the dump clearly targets another — ask only when genuinely ambiguous, and never more than once.

Document mode

Append a numbered task to PLAN.md:

  • Under the current open phase, taking the next free task number — existing tasks are NEVER renumbered. One carve-out: a number allocated on a branch is provisional until the branch merges. Two sessions reading the same plan draw the same number, and when the filings land at different offsets git merges them with no conflict (measured 2026-09-16, 5.17.1). So place the new task at the physical end of the phase's list, where a concurrent filing collides visibly instead of merging silently — and when two filings do collide, keep both and renumber the later-merged one; never drop either.
  • With its acceptance line (or the explicit TBD).
  • No obvious phase → a dated checkbox under ## Open items instead; /triage or the next /plan replan finds it a home.
  • No PLAN.md at all → do NOT create one. A plan scaffolded as a side effect of filing a ticket is a plan nobody designed. Say the item cannot be filed in document mode, print the well-formed task text so nothing is lost, and name /plan seed as what creates the document.

Report and stop

Report what was filed — the issue URL or the exact PLAN.md line, and in document mode that the number is provisional until the branch merges — and stop. Capture never starts the work (CONDUCT rule 5): /ticket writing code because the fix "looked quick" is exactly the failure mode this skill exists to prevent.

04 同仓库更多 Skills

AaravChadha
AaravChadha/acstack

why

Decision archaeology - answers why the code, config, or plan is the way it is by searching the record in a fixed order: BRIEF constraints, dated PLAN decisions, JOURNAL entries, then git history. Stops at the first real answer, cites it with a date, and says no recorded rationale rather than inventing one. Use when someone asks why something is this way, why a choice was made, or where a decision is written down.

★ 2
AaravChadha
AaravChadha/acstack

verify

Audit a completion claim made by someone else - another session, agent, or teammate - against the running system rather than the diff. Re-derives what the claim's acceptance demands, runs it, and returns CONFIRMED, OVERSTATED, FALSE or UNVERIFIABLE with the command and its output. Never fixes, never edits the claim or the acceptance. Use when handed a "done", "all green", "merged" or "it works" you did not produce yourself.

★ 2
AaravChadha
AaravChadha/acstack

triage

Backlog hygiene sweep - stale items, duplicate pairs, missing acceptance criteria, unblocked-but-unassigned work, and milestone burn, delivered as a report first with only user-approved actions applied. Works on GitHub Issues in tickets mode and on PLAN.md checkboxes in document mode. Use when the user asks to triage, groom, or clean up the backlog or the plan's open tasks.

★ 2
AaravChadha
AaravChadha/acstack

ship

Branch-level release with five gates before the act - clean-state, tests, eval-vs-target, docs drift, and attribution sweep; any failing gate stops the release with its output. Then push, and under push: branch-pr open a report-shaped PR wiring the issue-closing reference in tickets mode or PLAN task IDs in document mode. Use when the user asks to ship, release, cut, or open the PR for a feature or branch.

★ 2
AaravChadha
AaravChadha/acstack

secure

Security review with a confidence gate - a finding exists only with a concrete exploit scenario and a high/medium/low confidence rating; everything else goes to a worth-hardening list, never inflated. Sweeps five surfaces: auth gates, secrets hygiene, injection and unsafe sinks, unsafe deserialization/crypto/transport, and LLM tool-use trust boundaries. Reports only, never fixes. Use when the user asks for a security review or to check vulnerabilities, secrets, or auth.

★ 2
AaravChadha
AaravChadha/acstack

retro

Trend review across many sessions - velocity vs planned dates, eval-score trend toward target, failure-category trends from journal triage and investigations, and a status check on every open PLAN risk. Reads JOURNAL/PLAN/eval history, writes a dated retro entry into JOURNAL.md. Use when the user asks for a retro, a weekly review, or a phase-end wrap-up.

★ 2