← ClaudeAtlas

refinement-proposallisted

Use when reviewing one GitHub issue and proposing its refinement as a comment: Definition of Ready check, Fibonacci size and capacity estimate, ready or needs-refinement verdict, a proposed story with domain examples and acceptance criteria, what is vague or non-compliant in the current criteria, checked against a PRD or BRD under docs/ when the issue links one. Runs from the /skraft-refine command or a GitHub Agentic Workflow. Not for refining a whole sprint or triaging a backlog.
SebastienDegodez/skraft-plugin · ★ 14 · AI & Automation · score 70
Install: claude install-skill SebastienDegodez/skraft-plugin
# Refinement Proposal One issue in, one comment out. `{skill}` is the folder that holds this SKILL.md. Run every command from the repository root and call the scripts by their path, `node {skill}/scripts/<name>.mjs`: `docs/` and every relative path are read from the repository root, never from `{skill}`. Work in `/tmp/gh-aw/agent/skraft-refine/{number}/` in a GitHub Agentic Workflows run, in `.copilot-tracking/skraft-refine/{number}/` otherwise; call it `{work}`. Load before step 4: `issue-refinement`, `issue-triage`, `github-issue-search`. Load before step 5: `planning-review-criteria`, `backlog-review-lenses`. ## 1. Skip work already done (not in a workflow run: the workflow checked before starting) ```sh node {skill}/scripts/refine-marker.mjs check --repo <owner/repo> --issue <number> [--force] ``` `todo=false` → answer with its `reason` and stop. Pass `--force` only when the user asked for it. ## 2. Read the issue Read title, body, labels and comments through `github-issue-search`. Save the issue as JSON with at least `title` and `body` to `{work}/issue.json`. ## 3. Language Write every sentence you produce — story, examples, criteria, notes, defects, gaps — in the language of the issue's title and body; when they differ, the body's. Set `language` to its two-letter code (`fr`, `en`, `es`…). Never translate quoted text from the issue. ## 4. Assess and propose 1. Documents: `node {skill}/scripts/resolve-docs.mjs --issue-file {work}/issue.json --docs docs` and