aiworkflow-requirements

daishiman 的头像作者 daishiman

AIWorkflowOrchestratorプロジェクトの仕様管理スキル。仕様书を検索·背するためのインターfuェーsu。参考文献/配下に全仕様を格纳し、キーワード検索で必要な情报に素早くakakusesu。锚:•规范驱动开发 / 适用: 仕様书正本 / 目的: 実装との一贯性• Progressive Disclosure / 适用: 検索→详细 / 目的: コンテキsuto 效率化• MECE 原则 / 适用: トピック / 分类目的:漏れなく重复なく触发:プロジェクト仕様の検索、アーキテクチャ确认、API设计认知、セキュuriティ要件确认、テsuto戦略参照を行う场合に使用。仕様,要件,开发工具、API、开发工具、UI/UX、开发工具、Claude Code、开发工具、MSW、开发工具

📖 中文导读:AIWorkflowOrchestratorプロジェクトの仕様管理スキル。仕様书を検索·背するためのインターfuェーsu。参考文献/配下に全仕様を格纳し、キーワード検索で必要な情报に素早くakakusesu。锚:•规范驱动开发 / 适用: 仕様书正本 / 目的: 実装との一贯性• Progressive Disclosure / 适用: 検索→详细 / 目的: コンテキsuto 效率化• MECE 原则 / 适用: トピック / 分类目的:漏れなく重复なく触发:プロジェクト仕様の検索、アーキテクチャ确认、API设计认知、セキュuriティ要件确认、テsuto戦略参照を行う场合に使用。仕様,要件,开发工具、API、开发工具、UI/UX、开发工具、Claude Code、开发工具、MSW、开发工具 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: aiworkflow-requirements description: | AIWorkflowOrchestratorプロジェクトの仕様管理スキル。 仕様書を検索・参照するためのインターフェース。 references/配下に全仕様を格納し、キーワード検索で必要な情報に素早くアクセス。

Anchors: • Specification-Driven Development / 適用: 仕様書正本 / 目的: 実装との一貫性 • Progressive Disclosure / 適用: 検索→詳細参照 / 目的: コンテキスト効率化 • MECE原則 / 適用: トピック分類 / 目的: 漏れなく重複なく

Trigger: プロジェクト仕様の検索、アーキテクチャ確認、API設計参照、セキュリティ要件確認、テスト戦略参照を行う場合に使用。 仕様, 要件, アーキテクチャ, API, データベース, セキュリティ, UI/UX, デプロイ, Claude Code, テスト, MSW, カバレッジ allowed-tools: - Read - Glob - Grep - Bash

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 仕様正本化、検索中心に再設計