Agent skill

speckit-require

GitHub Spec Kit (https://github.com/github/spec-kit) を使って要件定義や仕様作成（仕様策定・仕様書作成・仕様設計を含む）を新規作成または既存仕様へ追記し、spec.md/plan.md/tasks.mdまで生成・更新する。要件定義、要件追加/変更、TDD前提の要件整理、仕様の明文化、Spec Kitのspecify/clarify/plan/tasksフロー実行が求められるときに使用。

View SKILL.md on GitHub Repository
Stars 5
Forks 2

Install this agent skill to your Project

npx add-skill https://github.com/akiojin/skills/tree/main/speckit/skills/speckit-require

SKILL.md

Requirements Spec Kit

GitHub Spec Kit: https://github.com/github/spec-kit

Overview

GitHub Spec Kit のリポジトリ内テンプレートとスクリプトを使い、要件定義を作成・更新して spec.md → plan.md → tasks.md を完成させる。新規作成か既存追記かを判断し、対象 SPEC を確定してから作業する。

決定フロー: 新規作成 or 既存追記

  • ユーザー入力で即決する: SPEC-ID、spec.md パス、または「追記/既存」指示があれば追記する。
  • 迷う場合は既存 SPEC を検索する: rg -n "# 機能仕様:" specs/SPEC-*/spec.md と主要キーワードで一致確認する。
  • 一致が1件なら追記する。複数一致なら候補（SPEC-IDとタイトル）を提示して選択を求める。
  • 一致が無ければ新規作成する。
  • 追記時は対象 SPEC の worktree/feature ブランチで作業する（.specify/scripts/bash/check-prerequisites.sh は最新 SPEC を選ぶため）。

ワークフロー（specify → clarify → plan → tasks）

1) specify

  • .specify/templates/commands/specify.md を読み、記載のスクリプトを1回実行する。
  • .specify/templates/spec-template.md を用いて spec.md を日本語で埋める。
  • 新規作成時はスクリプト出力の WORKTREE_PATH に移動して以降の作業を行う。
  • 既存追記時は該当セクションのみ更新し、見出し順・FR番号などの連番を維持する。
  • TDD/テスト要求がある場合は、要件または成功基準に「自動テストが必須」である旨を明記する。
  • specs/specs.md を更新し、優先度と状態を必ず記載する（update-spec-index.sh を使う場合も同様）。

2) clarify

  • .specify/templates/commands/clarify.md に従う。
  • 質問は最大5つに抑え、推奨回答を提示する。
  • 回答は spec.md の該当セクションへ即時反映する。

3) plan

  • .specify/templates/commands/plan.md に従う。
  • .specify/memory/constitution.md を参照し、ゲート評価を満たす。
  • 出力（plan.md / research.md / data-model.md / quickstart.md / contracts/）を生成する。

4) tasks

  • .specify/templates/commands/tasks.md に従う。
  • TDD/テスト要求がある場合はテストタスクを必ず含める。
  • tasks.md のチェックリスト形式（ID/Story/ファイルパス）を厳守する。

出力の報告

  • 生成/更新した spec.md、plan.md、tasks.md のパスを報告する。
  • 未解決の明確化が残る場合は、ユーザー回答を得てから次へ進む。

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

akiojin/skills

inkjs-design

Ink.js (React for CLI) design and implementation guide. Use when: (1) Creating or modifying Ink.js components (2) Implementing Ink-specific hooks (useInput, useApp, useFocus) (3) Handling emoji/icon width issues (string-width workarounds) (4) Building terminal-responsive layouts (5) Managing multi-screen navigation (6) Implementing animations (spinners, progress bars) (7) Optimizing performance (React.memo, useMemo) (8) Handling keyboard input and shortcuts (9) Testing CLI UI (ink-testing-library)

5 2
Explore
akiojin/skills

speckit-update

GitHub Spec Kit (https://github.com/github/spec-kit) のベースバージョン更新やテンプレート/スクリプト同期を行うための手順。Spec Kitの更新、上流リリースとの差分適用、templates/commands/scriptsの取り込み、ローカル運用（日本語化・ブランチ非操作・SPEC-[UUID8桁]）の維持が必要なときに使用する。

5 2
Explore
akiojin/skills

gh-fix-ci

Backward-compatible wrapper skill. The current workflow is `gh-fix-pr`.

5 2
Explore
akiojin/skills

gh-pr-check

Check GitHub PR status with the gh CLI, including unmerged PR detection and post-merge new-commit detection for the current branch.

5 2
Explore
akiojin/skills

gh-fix-issue

Analyze a GitHub Issue to extract error context, stack traces, file references, and cross-references. Classify the issue, search the codebase for relevant files, produce a structured Issue Analysis Report, and propose a concrete fix plan. Post progress updates to the issue.

5 2
Explore
akiojin/skills

gh-fix-pr

Inspect GitHub PR for CI failures, merge conflicts, update-branch requirements, reviewer comments, change requests, and unresolved review threads. Create fix plans and implement after user approval. Reply to ALL reviewer comments with action taken or reason for not addressing, then resolve threads. Notify reviewers after fixes.

5 2
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results