| name | aiworkflow-requirements |
| description | AIWorkflowOrchestratorプロジェクトの仕様管理スキル。
仕様書を検索・参照するためのインターフェース。
references/配下に全仕様を格納し、キーワード検索で必要な情報に素早くアクセス。
Anchors:
• Specification-Driven Development / 適用: 仕様書正本 / 目的: 実装との一貫性
• Progressive Disclosure / 適用: 検索→詳細参照 / 目的: コンテキスト効率化
• MECE原則 / 適用: トピック分類 / 目的: 漏れなく重複なく
Trigger:
プロジェクト仕様の検索、アーキテクチャ確認、API設計参照、セキュリティ要件確認、テスト戦略参照を行う場合に使用。
仕様, 要件, アーキテクチャ, API, データベース, セキュリティ, UI/UX, デプロイ, Claude Code, テスト, MSW, カバレッジ, PermissionStore, 権限永続化, rememberChoice
|
| allowed-tools | ["Read","Glob","Grep","Bash"] |
AIWorkflow Requirements Manager
概要
AIWorkflowOrchestratorプロジェクトの全仕様を管理するスキル。
このスキルが仕様の正本であり、references/配下のドキュメントを直接編集・参照する。
クイックスタート
仕様を探す
node scripts/search-spec.js "認証" -C 5
仕様を読む
- まず resource-map.md を確認 - タスク種別に応じた読み込みファイルを特定
- 該当ファイルを
Read ツールで参照
- 詳細行番号が必要な場合は topic-map.md を参照
仕様を作成・更新
assets/ 配下の該当テンプレートを使用references/spec-guidelines.md の命名規則に従う- 編集後は
node scripts/generate-index.js を実行
ワークフロー
┌→ search-spec ────┐
user-request → ┼ ┼→ read-reference → apply-to-task
└→ browse-index ───┘
↓
(仕様変更が必要な場合)
↓
┌→ create-spec ──────────┐
┼ ┼→ update-index → validate-structure
└→ update-spec ──────────┘
Task仕様ナビ
| Task | 責務 | 起動タイミング | 入力 | 出力 |
|---|
| search-spec | 仕様検索 | 仕様確認が必要な時 | キーワード | ファイルパス一覧 |
| browse-index | 全体像把握 | 構造理解が必要な時 | なし | トピック構造 |
| read-reference | 仕様参照 | 詳細確認が必要な時 | ファイルパス | 仕様内容 |
| create-spec | 新規作成 | 新機能追加時 | 要件 | 新規仕様ファイル |
| update-spec | 既存更新 | 仕様変更時 | 変更内容 | 更新済みファイル |
| update-index | インデックス化 | 見出し変更後 | references/ | indexes/ |
| validate-structure | 構造検証 | 週次/リリース前 | 全体 | 検証レポート |
リソース参照
仕様ファイル一覧
See indexes/resource-map.md（読み込み条件付き）
詳細セクション・行番号: indexes/topic-map.md
| カテゴリ | 主要ファイル |
|---|
| 概要・品質 | overview.md, quality-requirements.md |
| アーキテクチャ | architecture-overview.md, architecture-patterns.md, arch-*.md |
| インターフェース | interfaces-agent-sdk.md, llm-*.md, rag-search-*.md |
| API設計 | api-endpoints.md, api-ipc-*.md |
| データベース | database-schema.md, database-implementation.md |
| UI/UX | ui-ux-components.md, ui-ux-design-principles.md, ui-history-*.md |
| セキュリティ | security-principles.md, security-electron-ipc.md, security-*.md |
| 技術スタック | technology-core.md, technology-frontend.md, technology-desktop.md |
| Claude Code | claude-code-overview.md, claude-code-skills-*.md |
| デプロイ・運用 | deployment.md, deployment-electron.md, environment-variables.md |
| ガイドライン | spec-guidelines.md, development-guidelines.md, architecture-implementation-patterns.md, rag-*.md |
注記: 18-skills.md（Skill層仕様書）は skill-creator スキルで管理。
scripts/
| スクリプト | 用途 | 使用例 |
|---|
search-spec.js | キーワード検索 | node scripts/search-spec.js "認証" -C 5 |
list-specs.js | ファイル一覧 | node scripts/list-specs.js --topics |
generate-index.js | インデックス再生成 | node scripts/generate-index.js |
validate-structure.js | 構造検証 | node scripts/validate-structure.js |
select-template.js | テンプレート選定 | node scripts/select-template.js "IPC仕様" |
split-reference.js | 大規模ファイル分割 | node scripts/split-reference.js <file> |
remove-heading-numbers.js | 見出し番号削除 | node scripts/remove-heading-numbers.js |
log_usage.js | 使用状況記録 | node scripts/log_usage.js --result success |
agents/
| エージェント | 用途 | 対応Task | 主な機能 |
|---|
create-spec.md | 新規仕様作成 | create-spec | テンプレート対応、重複チェック |
update-spec.md | 既存仕様更新 | update-spec | テンプレート準拠、分割ガイド |
validate-spec.md | 仕様検証 | validate-structure | resource-map登録確認、サイズ検証 |
indexes/
| ファイル | 内容 | 用途 |
|---|
quick-reference.md | キー情報の即時アクセス（推奨・最初に読む） | パターン/型/IPC早見表 |
resource-map.md | リソースマップ（読み込み条件付き） | タスク種別→ファイル |
topic-map.md | トピック別マップ（セクション・行番号詳細） | セクション直接参照 |
keywords.json | キーワード索引（自動生成） | スクリプト検索用 |
Progressive Disclosure: まずresource-map.mdでタスクに必要なファイルを特定し、必要なファイルのみを読み込む。
templates/
新規仕様書作成時のテンプレート。node scripts/select-template.js で自動選定可能。
| ファイル | 用途 | 対象カテゴリ |
|---|
spec-template.md | 汎用仕様テンプレート | 概要・品質 |
interfaces-template.md | インターフェース仕様 | インターフェース |
architecture-template.md | アーキテクチャ仕様 | アーキテクチャ |
api-template.md | API設計 | API設計 |
ipc-channel-template.md | Electron IPC | IPC通信 |
react-hook-template.md | React Hook | カスタムフック |
service-template.md | サービス層 | ビジネスロジック |
database-template.md | データベース仕様 | データベース |
ui-ux-template.md | UI/UX仕様 | UI/UX |
security-template.md | セキュリティ仕様 | セキュリティ |
testing-template.md | テスト仕様 | テスト戦略 |
注記: 詳細はtemplates/配下を直接参照。追加テンプレートが必要な場合は agents/create-spec.md を参照。
references/（ガイドライン）
| ファイル | 内容 |
|---|
spec-guidelines.md | 命名規則・記述ガイドライン |
spec-splitting-guidelines.md | 大規模ファイル分割ガイドライン |
連携スキル
| スキル | 用途 |
|---|
task-specification-creator | タスク仕様書作成、Phase 12での仕様更新ワークフロー管理 |
Phase 12 仕様更新時: .claude/skills/task-specification-creator/references/spec-update-workflow.md を参照
運用ファイル
| ファイル | 用途 |
|---|
EVALS.json | スキルレベル・メトリクス管理 |
LOGS.md | 使用履歴・フィードバック記録 |
ベストプラクティス
すべきこと
- キーワード検索で情報を素早く特定
- 編集後は
node scripts/generate-index.js を実行
- 500行超過時はインデックス+サブファイル形式に手動分割
避けるべきこと
- references/以外に仕様情報を分散
- インデックス更新を忘れる
- 詳細ルールをSKILL.mdに追加（→ spec-guidelines.md へ）
詳細ルール: See references/spec-guidelines.md
変更履歴
| Version | Date | Changes |
|---|
| 8.6.0 | 2026-01-26 | 仕様ガイドライン完全準拠: 全134ファイル（133ファイルコードブロック除去完了、spec-guidelines.md除く）のspec-guidelines.md準拠修正。82参照ファイルのTypeScript/JSON/SQL/ASCIIダイアグラムを表形式・文章に変換 |
| 8.5.0 | 2026-01-26 | 仕様ガイドライン準拠修正: architecture-overview.md/technology-desktop.md（ディレクトリ構造を表形式化）、development-guidelines.md/architecture-implementation-patterns.md（コード例を表形式・文章に変換）、templates全11種（コード例を表形式に変換） |
| 8.4.0 | 2026-01-26 | 実装パターン総合ガイド追加: architecture-implementation-patterns.md新規作成（フロントエンド/バックエンド/デスクトップ/パフォーマンス/セキュリティ/テスト/アクセシビリティ実装パターン網羅） |
| 8.3.0 | 2026-01-26 | 開発ガイドライン拡充: development-guidelines.md v1.1.0（命名規則、デバッグガイド、リリースプロセス、バックアップ・リカバリ、環境構築ガイド追加） |
| 8.2.0 | 2026-01-26 | UX法則・開発ガイドライン追加: ui-ux-design-principles.mdにUXデザイン法則（Fitts, Hick, Jakob, Miller, Gestalt, Progressive Disclosure等）追加、development-guidelines.md新規作成（ロギング、キャッシング、マイグレーション、コードレビュー、i18n） |
| 8.1.0 | 2026-01-26 | アーキテクチャ総論追加: architecture-overview.md新規作成、technology-frontend.md/technology-desktop.md追加、templates/ディレクトリ新設（テンプレート11種） |
| 8.0.0 | 2026-01-26 | 大規模リファクタリング: 94→129ファイル拡張（+35分割ファイル）、resource-map.md全ファイル網羅（v1.2.0）、エージェント3件v2.1.0更新、Progressive Disclosure原則に基づくインデックス最適化 |
| 7.2.0 | 2026-01-26 | エージェント改善: create-spec/update-spec/validate-spec v2.0.0更新（16テンプレート対応、select-template.js統合、quick-reference.md/resource-map.md参照追加、テンプレート準拠検証ワークフロー追加） |
| 7.1.0 | 2026-01-26 | 追加最適化: 16種テンプレート（ipc-channel, react-hook, service, error-handling, testing追加）、quick-reference.md新設、indexes/セクション強化 |
| 7.0.0 | 2026-01-26 | スキルリファクタリング: 11種テンプレート追加、interfaces-agent-sdk.md分割（6ファイル）、resource-map.md新設（読み込み条件付き）、spec-splitting-guidelines.md追加、SKILL.mdクイックスタート追加。94ファイル・11カテゴリ構成に拡張 |
| 6.31.0 | 2026-01-26 | TASK-3-1-E完了: security-skill-execution.mdにPermission Storeセクション追加、ui-ux-settings.mdにPermissionSettings UI追加、interfaces-agent-sdk.md更新。159テスト・96%カバレッジ達成 |
| 6.30.0 | 2026-01-26 | TASK-4-2完了: interfaces-agent-sdk.md v2.2.0更新（PermissionResolver IPC Handlers完了記録、IPCチャンネル2種、Preload API、usePermissionDialog Hook、PermissionDialog）、security-api-electron.md更新（Permission IPCセキュリティ）。93テスト・94.67%カバレッジ |
