AgentSkillsCN

spec-refiner

使用 tasks/ 工作流创建严格的任务简报和交接说明。

SKILL.md
--- frontmatter
name: spec-refiner
description: Creates a strict Task Brief and a handoff note using the tasks/ workflow.

spec-refiner

When to use

Use this skill when asked to:

  • •refine a raw request into a concrete, verifiable spec
  • •produce a Task Brief + handoff note for an Implementer

Rules

  • •Read AGENTS.md before drafting the brief.
  • •Ask at most 3 questions only if absolutely required.
  • •Otherwise make conservative assumptions and label them explicitly.
  • •Use the file-based handoff protocol in tasks/ (no copy/paste between agents).

Method

  1. •Create a new task folder using python tools/new_task.py "<Task Title>" if available.
  2. •Fill tasks/<date>_<slug>/00_task_brief.md using the required sections.
  3. •Capture Goal, Scope/Non-scope, Constraints, Acceptance criteria, File touch list, and a small-diff plan with numbered stages (Stage 1, Stage 2, etc.) so progress is easy to track.
  4. •If needed, ask up to 3 blocking questions.
  5. •Write a short handoff instruction telling the Implementer to read the task files.

Output requirements

  • •The Task Brief lives in tasks/<date>_<slug>/00_task_brief.md.
  • •Provide a short handoff instruction only (no full brief pasted into chat).