aiworkflow-requirements

AIWorkflowOrchestratorプロジェクトの仕様管理スキル。仕様書を検索・参照するためのインターフェース。references/配下に全仕様を格納し、キーワード検索で必要な情報に素早くアクセス。Anchors:• Specification-Driven Development / 適用: 仕様書正本 / 目的: 実装との一貫性• Progressive Disclosure / 適用: 検索→詳細参照 / 目的: コンテキスト効率化• MECE原則 / 適用: トピック分類 / 目的: 漏れなく重複なくTrigger:プロジェクト仕様の検索、アーキテクチャ確認、API設計参照、セキュリティ要件確認、テスト戦略参照を行う場合に使用。仕様, 要件, アーキテクチャ, API, データベース, セキュリティ, UI/UX, デプロイ, Claude Code, テスト, MSW, カバレッジ

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026

When & Why to Use This Skill

The AIWorkflow Requirements Manager is a specialized Claude skill designed for Specification-Driven Development (SDD). It serves as the authoritative 'Source of Truth' for project documentation, managing over 70 specification files across 10 technical topics including architecture, API design, and security. By providing a structured interface to search, reference, and update requirements, it ensures high implementation consistency and optimizes context efficiency for complex software engineering workflows.

Use Cases

  • Case 1: Rapidly retrieving specific API designs, database schemas, or security requirements from a large-scale documentation set using keyword-based search.
  • Case 2: Maintaining architectural integrity during feature development by cross-referencing implementation details with the project's master specifications.
  • Case 3: Automating the lifecycle of technical documentation, including the creation of new specs from templates and the automatic regeneration of topic indexes.
  • Case 4: Performing structural validation and MECE-principle checks on project requirements to ensure no overlaps or gaps exist in the technical documentation before a major release.
nameaiworkflow-requirements
description|
• Specification-Driven Development / 適用仕様書正本 / 目的: 実装との一貫性
• Progressive Disclosure / 適用検索→詳細参照 / 目的: コンテキスト効率化
• MECE原則 / 適用トピック分類 / 目的: 漏れなく重複なく

AIWorkflow Requirements Manager

概要

AIWorkflowOrchestratorプロジェクトの全仕様(70ファイル・約17,000行)を管理するスキル。 このスキルが仕様の正本であり、references/配下のドキュメントを直接編集・参照する。

ワークフロー

                    ┌→ 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 構造検証 週次/リリース前 全体 検証レポート

リソース参照

仕様ファイル一覧

49ファイル・10トピック: See indexes/topic-map.md

トピック ファイル数
概要・品質 4
アーキテクチャ 6
インターフェース 7
API設計 3
データベース 3
UI/UX 6
セキュリティ 3
技術スタック 3
Claude Code 6
その他 9

注記: 18-skills.md(Skill層仕様書)は skill-creator スキルで管理。

scripts/

スクリプト 用途 使用例
search-spec.mjs キーワード検索 node scripts/search-spec.mjs "認証" -C 5
list-specs.mjs ファイル一覧 node scripts/list-specs.mjs --topics
generate-index.mjs インデックス再生成 node scripts/generate-index.mjs
validate-structure.mjs 構造検証 node scripts/validate-structure.mjs
log_usage.mjs 使用状況記録 node scripts/log_usage.mjs --result success

agents/

エージェント 用途 対応Task
create-spec.md 新規仕様作成 create-spec
update-spec.md 既存仕様更新 update-spec
validate-spec.md 仕様検証 validate-structure

indexes/

ファイル 内容
topic-map.md トピック別マップ(詳細)
keywords.json キーワード索引(自動生成)

assets/

ファイル 用途
spec-template.md 新規仕様のテンプレート

references/(ガイドライン)

ファイル 内容
spec-guidelines.md 命名規則・記述ガイドライン

運用ファイル

ファイル 用途
EVALS.json スキルレベル・メトリクス管理
LOGS.md 使用履歴・フィードバック記録

ベストプラクティス

すべきこと

  • キーワード検索で情報を素早く特定
  • 編集後は node scripts/generate-index.mjs を実行
  • 500行超過時はインデックス+サブファイル形式に手動分割

避けるべきこと

  • references/以外に仕様情報を分散
  • インデックス更新を忘れる
  • 詳細ルールをSKILL.mdに追加(→ spec-guidelines.md へ)

詳細ルール: See references/spec-guidelines.md

変更履歴

Version Date Changes
6.11.0 2026-01-17 architecture-patterns.md更新: IPC Handler Registration Pattern追加(SKILL-IPC-001完了記録、登録パターン3種の文書化、セキュリティ要件)
6.10.0 2026-01-14 ui-ux-settings.md新規追加: スライド出力ディレクトリ設定機能のUI/UX仕様・IPC API仕様・セキュリティ要件(slideSettingsAPI)
6.9.0 2026-01-13 Knowledge Graph Store実装完了: interfaces-rag-knowledge-graph-store.md v1.0.1更新、実装詳細追加(Entity/Relation CRUD、グラフ探索、バッチ操作)、カバレッジ86.98%達成
6.8.0 2026-01-13 AgentSDKPage Postrelease Testing仕様追加: interfaces-agent-sdk.mdに約150行追加(AGENT-005-POST)
6.7.0 2026-01-12 未タスク指示書3件作成(renderer-build-fix、history-gui-manual-test、error-i18n-support)、ui-ux-history-panel.md v1.6.0更新
6.6.1 2026-01-12 history-service-db-integration実装内容追加: architecture-file-conversion.md、api-internal-conversion.mdにElectron統合セクション追加
6.6.0 2026-01-12 VectorSearchStrategy仕様追加: interfaces-rag-search.mdにISearchStrategy実装一覧/Result型/フィルタ対応表/CachedVectorSearchStrategy追加、architecture-rag.mdにVectorSearchStrategyセクション追加
6.5.0 2026-01-12 Agent Execution UI仕様追加(AGENT-004): interfaces-agent-sdk.md/ui-ux-components.mdに約550行追加、topic-map.md更新
6.4.0 2026-01-12 GraphRAGクエリサービス仕様追加: interfaces-rag-graphraph-query.md新規、architecture-rag.md更新、topic-map.md更新
6.3.0 2026-01-11 コミュニティ要約仕様追加: interfaces-rag-community-summarization.md新規、interfaces-rag-community-detection.md更新(v1.1.0)、topic-map.md更新
6.2.0 2026-01-10 コミュニティ検出(Leiden)仕様追加: interfaces-rag-community-detection.md新規、interfaces-rag.md/architecture-rag.md/topic-map.md更新
6.1.0 2026-01-06 500行超過ファイル分割(9ファイル→インデックス化)、70ファイル構成に拡張
6.0.0 2026-01-06 skill-creator準拠: agents/をTask仕様書テンプレート化、EVALS.json/LOGS.md/log_usage.mjs追加
5.0.0 2026-01-04 SKILL.md軽量化、詳細をindexes/references/へ分離
4.0.0 2026-01-03 kebab-case化、大ファイル分割、47ファイル構成
3.0.0 2026-01-03 仕様正本化、検索中心に再設計