agentmods.dev

specify

A command that turns a natural-language feature description into a structured feature specification. It creates or updates spec.md, a document describing what a feature should do and why.

In plain words
What is it for?
Use it to extract users, actions, data, constraints, scenarios, requirements, success criteria, and related entities from a feature description.
Why use it?
It gives an informal idea a consistent, testable structure before technical planning begins. It also highlights important uncertainties when a reasonable default is not available.

Command

34 9d ago A scan 31 tokens original MIT
View the source file akiojin/unity-mcp-server
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/akiojin/unity-mcp-server/specify
Clone the repo
git clone --depth 1 https://github.com/akiojin/unity-mcp-server
Per session 31 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,721 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00031 $0.01721
Opus 5 $0.00015 $0.00860
Sonnet 5 $0.00006 $0.00344
Haiku 4.5 $0.00003 $0.00172

Measured 2d ago against content hash 29f02cc887ae, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

specify scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.specify/templates/commands/specify.md · 128 lines

How it starts

The opening of the file, as written. The whole thing — 128 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ユーザー入力

$ARGUMENTS

空でない場合、続行する前にユーザー入力を考慮する必要があります。

概要

/speckit.specify の後にユーザーが入力したテキストが要件説明です。{ARGS} が空でない限り、それを要件説明として使用します。

実行手順

  1. スクリプト実行: {SCRIPT} をリポジトリルートから実行し、JSON出力から FEATURE_ID / FEATURE_DIR / SPEC_FILE を取得します（パスはすべて絶対パス）。

    • シングルクォートを含む引数（例: "I'm Groot"）は 'I'\''m Groot' のようにエスケープ

  2. テンプレート読み込み: .specify/templates/spec-template.md を読み、必須セクションと見出し構造を理解します。

  3. 仕様書作成: SPEC_FILE をテンプレート構造に沿って埋めます:

    実行フロー:

    1. ユーザー入力を解析 → 空の場合はエラー
    2. キーコンセプトを抽出（アクター、アクション、データ、制約）
    3. 不明な点は:
      • 文脈や業界標準から推測
      • [要明確化: 具体的な質問] は以下の場合のみ:
        • 機能スコープやUXに大きく影響
        • 複数の解釈が可能
        • 合理的なデフォルトがない
      • 最大3つまで（スコープ > セキュリティ > UX > 技術詳細の優先順位）
    4. ユーザーシナリオとテストセクションを埋める
    5. 機能要件を生成（各要件はテスト可能であること）
    6. 成功基準を定義（測定可能、技術非依存）
    7. キーエンティティを特定（データが関係する場合）

    ガイドライン:

    • 「何を」「なぜ」を中心に書く（実装方法・技術スタック・API・コード構造は書かない）
    • ユーザーストーリーは優先度順（P1→P2→P3）で、独立してテスト可能にする
    • ビジネスステークホルダー向けに書く（開発者向けではない）

  4. 仕様品質チェックリスト: FEATURE_DIR/checklists/requirements.md に作成:

    # 仕様品質チェックリスト: [機能名]

**目的**: 計画フェーズに進む前に仕様の完全性と品質を検証
**作成日**: [日付]
**対象**: [spec.mdへのリンク]

## コンテンツ品質

- [ ] 実装詳細（言語、フレームワーク、API）が含まれていない
- [ ] ユーザー価値とビジネスニーズに焦点を当てている
- [ ] 非技術者向けに書かれている
- [ ] 必須セクションがすべて完了している

## 要件の完全性

- [ ] [要明確化]マーカーが残っていない
- [ ] 要件がテスト可能で曖昧でない
- [ ] 成功基準が測定可能
- [ ] 成功基準が技術非依存
- [ ] すべての受け入れシナリオが定義されている
- [ ] エッジケースが特定されている
- [ ] スコープが明確に境界付けられている
- [ ] 依存関係と前提条件が特定されている

## 機能準備状況

- [ ] すべての機能要件に明確な受け入れ基準がある
- [ ] ユーザーシナリオが主要フローをカバー
- [ ] 仕様に実装詳細が漏れていない

  5. 品質検証: チェックリストに照らして仕様を検証:

    • すべて合格: ステップ6へ
    • 失敗項目あり: 仕様を更新して再検証（最大3回）
    • [要明確化]が残っている場合: ユーザーに選択肢を提示（最大3つ）

  6. 完了報告:

    • FEATURE_ID と SPEC_FILE
    • specs/specs.md（要件一覧）が更新されている旨
    • 次ステップ /speckit.clarify または /speckit.plan

成功基準ガイドライン

成功基準は以下を満たすこと:

  1. 測定可能: 具体的なメトリクス（時間、パーセンテージ、件数、レート）
  2. 技術非依存: フレームワーク、言語、データベース、ツールに言及しない
  3. ユーザー中心: システム内部ではなく、ユーザー/ビジネス視点の結果
  4. 検証可能: 実装詳細を知らなくてもテスト/検証可能

Read the full file on GitHub · 128 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 128 lines · 31 tokens per session scan A 29f02cc887ae

Subscribe to this mod's changes

specify is a command published in the GitHub repository akiojin/unity-mcp-server (34 stars, last pushed 9d ago), licensed MIT. It adds 31 tokens to every session and 1,721 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

DocumentsPlanning
Related

Other commands, from other repositories

checklist

Generate a custom checklist for the current feature based on user requirements.

github/spec-kit · 13 tokens

clarify

Identify underspecified areas in the current feature spec by asking up to 5 highly targeted clarification questions and encoding answers back into the spec.

github/spec-kit · 27 tokens

specify

Create or update the feature specification from a natural language feature description.

github/spec-kit · 13 tokens

analyze

Perform a non-destructive cross-artifact consistency and quality analysis across spec.md, plan.md, and tasks.md after task generation.

github/spec-kit · 26 tokens

constitution

Create or update the project constitution from interactive or provided principle inputs.

github/spec-kit · 13 tokens

converge

Assess the current codebase against the feature's spec, plan, and tasks, then append any remaining unbuilt work as new tasks to tasks.md so implement can complete it.

github/spec-kit · 35 tokens