Back to list
daishiman

aiworkflow-requirements

by daishiman

4🍴 0📅 Jan 24, 2026

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プロジェクトの全仕様(88ファイル・約22,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構造検証週次/リリース前全体検証レポート

リソース参照

仕様ファイル一覧

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

トピックファイル数
概要・品質4
アーキテクチャ8
インターフェース19
API設計8
データベース4
UI/UX13
セキュリティ5
技術スタック3
Claude Code10
その他14

注記: 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命名規則・記述ガイドライン

連携スキル

スキル用途
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.mjs を実行
  • 500行超過時はインデックス+サブファイル形式に手動分割

避けるべきこと

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

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

変更履歴

VersionDateChanges
6.26.02026-01-24UT-LLM-HISTORY-001完了: interfaces-llm.md(Conversation/Message型、IPC契約7種)、architecture-patterns.md(会話履歴永続化パターン〜100行)追加。114テスト・100%カバレッジ達成
6.25.02026-01-24TASK-2B SkillImportStore追加: interfaces-agent-sdk.mdに「SkillImportStore(TASK-2B)」セクション新設(スキーマ・API・セキュリティ・テスト仕様詳細約230行)、SkillImportManagerとの差分表追加
6.24.02026-01-24スキル実行セキュリティ追加(TASK-2C完了): security-skill-execution.md新規作成(危険コマンド24パターン、保護パス25、許可ツール11)、security-implementation.mdにリンク追加、91ファイル構成
6.23.02026-01-24SkillScanner将来改善ロードマップ追加: architecture-patterns.md(3件の未タスク仕様書記録:キャッシュ/増分スキャン/ページネーション、想定追加型定義)
6.22.02026-01-24TASK-2A(SkillScanner実装)完了: interfaces-agent-sdk.md(ScannedSkillMetadata/SkillScannerOptions型、完了記録)、architecture-patterns.md(SkillScannerサブセクション追加:API/定数/セキュリティ/データフロー)
6.21.02026-01-23Workspace Chat Edit追加: interfaces-llm.md(FileContext/EditCommand/GeneratedResult型)、architecture-patterns.md(chatEditSliceパターン)、api-endpoints.md(chat-edit IPCチャネル4種)追加、89ファイル構成
6.20.02026-01-23TASK-1-1型定義追加: interfaces-agent-sdk.mdに「Skill Import Agent System 型定義(TASK-1-1)」セクション新設(16型詳細仕様)、連携スキル参照追加、88ファイル構成に拡張
6.19.02026-01-22React Context DI追加(UT-006完了): architecture-chat-history.mdにUI Layerセクション追加(ChatHistoryContext/Provider/useChatHistory/MockProvider)、topic-map.md更新、8アーキテクチャファイル構成
6.18.02026-01-22Drizzle Repository実装追加: architecture-chat-history.md更新(DrizzleChatSessionRepository/DrizzleChatMessageRepository、エラーハンドリング、テスト構成)
6.17.02026-01-21スキル管理IPC整合性修正: interfaces-agent-sdk.mdのIPCチャンネル名を実装に合わせて更新(skill:listskill:list-imported等)、戻り値型をOperationResultに統一
6.16.02026-01-21統計更新: ファイル数85、行数約20,000行に更新。CONV-06-04(NER)/CONV-07-02(FTS5)完了反映
6.15.02026-01-19NER仕様独立化&FTS5詳細化: interfaces-rag-entity-extraction.md新規作成、interfaces-rag-search.md FTS5/BM25詳細追加(テーブル構造、クエリパターン、データフロー)、85ファイル構成に拡張
6.14.02026-01-19スキル実行機能追加: interfaces-agent-sdk.mdにskill:executeIPC/skillAPI.execute/SkillRunResult型/OperationResult型追加、関連ドキュメントリンク追加
6.13.02026-01-19CONV-06-04完了: エンティティ抽出サービス(NER) Phase 12完了。interfaces-rag.md/architecture-rag.md更新(224テスト、97.1%カバレッジ、96.8%品質スコア)
6.12.02026-01-18SECURITY-001完了: interfaces-chat-history.md v2.0.0更新(認可セクション追加、requestUserIdパラメータ、BR-SESSION-005)、error-handling.md更新(ERR_2006 UNAUTHORIZED、UnauthorizedErrorクラス詳細)
6.11.02026-01-17architecture-patterns.md更新: IPC Handler Registration Pattern追加(SKILL-IPC-001完了記録、登録パターン3種の文書化、セキュリティ要件)
6.10.02026-01-14ui-ux-settings.md新規追加: スライド出力ディレクトリ設定機能のUI/UX仕様・IPC API仕様・セキュリティ要件(slideSettingsAPI)
6.9.02026-01-13Knowledge Graph Store実装完了: interfaces-rag-knowledge-graph-store.md v1.0.1更新、実装詳細追加(Entity/Relation CRUD、グラフ探索、バッチ操作)、カバレッジ86.98%達成
6.8.02026-01-13AgentSDKPage Postrelease Testing仕様追加: interfaces-agent-sdk.mdに約150行追加(AGENT-005-POST)
6.7.02026-01-12未タスク指示書3件作成(renderer-build-fix、history-gui-manual-test、error-i18n-support)、ui-ux-history-panel.md v1.6.0更新
6.6.12026-01-12history-service-db-integration実装内容追加: architecture-file-conversion.md、api-internal-conversion.mdにElectron統合セクション追加
6.6.02026-01-12VectorSearchStrategy仕様追加: interfaces-rag-search.mdにISearchStrategy実装一覧/Result型/フィルタ対応表/CachedVectorSearchStrategy追加、architecture-rag.mdにVectorSearchStrategyセクション追加
6.5.02026-01-12Agent Execution UI仕様追加(AGENT-004): interfaces-agent-sdk.md/ui-ux-components.mdに約550行追加、topic-map.md更新
6.4.02026-01-12GraphRAGクエリサービス仕様追加: interfaces-rag-graphraph-query.md新規、architecture-rag.md更新、topic-map.md更新
6.3.02026-01-11コミュニティ要約仕様追加: interfaces-rag-community-summarization.md新規、interfaces-rag-community-detection.md更新(v1.1.0)、topic-map.md更新
6.2.02026-01-10コミュニティ検出(Leiden)仕様追加: interfaces-rag-community-detection.md新規、interfaces-rag.md/architecture-rag.md/topic-map.md更新
6.1.02026-01-06500行超過ファイル分割(9ファイル→インデックス化)、70ファイル構成に拡張
6.0.02026-01-06skill-creator準拠: agents/をTask仕様書テンプレート化、EVALS.json/LOGS.md/log_usage.mjs追加
5.0.02026-01-04SKILL.md軽量化、詳細をindexes/references/へ分離
4.0.02026-01-03kebab-case化、大ファイル分割、47ファイル構成
3.0.02026-01-03仕様正本化、検索中心に再設計

Score

Total Score

45/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

0/5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon