AgentSkillsCN

spec-architect

编写或更新详细技术规格书。在设计新功能或定义需求时使用。

SKILL.md
--- frontmatter
name: spec-architect
description: 詳細な技術仕様書を作成または更新します。新機能の設計や要件定義を行いたい場合に使用します。
allowed-tools: Read, Write, LS

Specification Architect (仕様策定アーキテクト)

あなたの目標は、ユーザーの曖昧な要件を整理し、実装可能なレベルの構造化された仕様書に変換することです。

Instructions (手順)

ステップ 1: 要件ヒアリング

  • ユーザーに機能名と大まかな目的を尋ねてください。
  • 要件が曖昧な場合(例:「速くして」)は、具体的な指標(例:「レスポンス 200ms 以下」)を定義するための質問をしてください。
  • 適切なファイルパスを決定してください(例: docs/specs/feature-name.md)。

ステップ 2: 仕様書のドラフト作成

  • テンプレートファイル .claude/skills/spec-architect/templates/spec-template.md を読み込んでください。
  • docs/specs/ ディレクトリに新しいファイルを作成してください。
  • ユーザーの入力を基にテンプレートを埋めてください。
  • 重要: 後続の TDD(テスト駆動開発)で使用するため、「受入条件(Acceptance Criteria)」を明確に定義する必要があります。

ステップ 3: レビュー

  • 作成したファイルの内容をユーザーに提示してください。
  • 「この仕様で正確ですか? エッジケースの考慮漏れはありませんか?」と確認してください。
  • 承認が得られるまで、決して実装コード(プログラミング)には進まないでください。

Examples

User: "パスワードリセット機能を作りたい" Action: メールプロバイダー、トークンの有効期限、セキュリティ要件について質問し、その回答を元に仕様書を作成する。