
aiworkflow-requirements
by daishiman
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/UX | 13 |
| セキュリティ | 5 |
| 技術スタック | 3 |
| Claude Code | 10 |
| その他 | 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
変更履歴
| Version | Date | Changes |
|---|---|---|
| 6.26.0 | 2026-01-24 | UT-LLM-HISTORY-001完了: interfaces-llm.md(Conversation/Message型、IPC契約7種)、architecture-patterns.md(会話履歴永続化パターン〜100行)追加。114テスト・100%カバレッジ達成 |
| 6.25.0 | 2026-01-24 | TASK-2B SkillImportStore追加: interfaces-agent-sdk.mdに「SkillImportStore(TASK-2B)」セクション新設(スキーマ・API・セキュリティ・テスト仕様詳細約230行)、SkillImportManagerとの差分表追加 |
| 6.24.0 | 2026-01-24 | スキル実行セキュリティ追加(TASK-2C完了): security-skill-execution.md新規作成(危険コマンド24パターン、保護パス25、許可ツール11)、security-implementation.mdにリンク追加、91ファイル構成 |
| 6.23.0 | 2026-01-24 | SkillScanner将来改善ロードマップ追加: architecture-patterns.md(3件の未タスク仕様書記録:キャッシュ/増分スキャン/ページネーション、想定追加型定義) |
| 6.22.0 | 2026-01-24 | TASK-2A(SkillScanner実装)完了: interfaces-agent-sdk.md(ScannedSkillMetadata/SkillScannerOptions型、完了記録)、architecture-patterns.md(SkillScannerサブセクション追加:API/定数/セキュリティ/データフロー) |
| 6.21.0 | 2026-01-23 | Workspace Chat Edit追加: interfaces-llm.md(FileContext/EditCommand/GeneratedResult型)、architecture-patterns.md(chatEditSliceパターン)、api-endpoints.md(chat-edit IPCチャネル4種)追加、89ファイル構成 |
| 6.20.0 | 2026-01-23 | TASK-1-1型定義追加: interfaces-agent-sdk.mdに「Skill Import Agent System 型定義(TASK-1-1)」セクション新設(16型詳細仕様)、連携スキル参照追加、88ファイル構成に拡張 |
| 6.19.0 | 2026-01-22 | React Context DI追加(UT-006完了): architecture-chat-history.mdにUI Layerセクション追加(ChatHistoryContext/Provider/useChatHistory/MockProvider)、topic-map.md更新、8アーキテクチャファイル構成 |
| 6.18.0 | 2026-01-22 | Drizzle Repository実装追加: architecture-chat-history.md更新(DrizzleChatSessionRepository/DrizzleChatMessageRepository、エラーハンドリング、テスト構成) |
| 6.17.0 | 2026-01-21 | スキル管理IPC整合性修正: interfaces-agent-sdk.mdのIPCチャンネル名を実装に合わせて更新(skill:list→skill:list-imported等)、戻り値型をOperationResultに統一 |
| 6.16.0 | 2026-01-21 | 統計更新: ファイル数85、行数約20,000行に更新。CONV-06-04(NER)/CONV-07-02(FTS5)完了反映 |
| 6.15.0 | 2026-01-19 | NER仕様独立化&FTS5詳細化: interfaces-rag-entity-extraction.md新規作成、interfaces-rag-search.md FTS5/BM25詳細追加(テーブル構造、クエリパターン、データフロー)、85ファイル構成に拡張 |
| 6.14.0 | 2026-01-19 | スキル実行機能追加: interfaces-agent-sdk.mdにskill:executeIPC/skillAPI.execute/SkillRunResult型/OperationResult型追加、関連ドキュメントリンク追加 |
| 6.13.0 | 2026-01-19 | CONV-06-04完了: エンティティ抽出サービス(NER) Phase 12完了。interfaces-rag.md/architecture-rag.md更新(224テスト、97.1%カバレッジ、96.8%品質スコア) |
| 6.12.0 | 2026-01-18 | SECURITY-001完了: interfaces-chat-history.md v2.0.0更新(認可セクション追加、requestUserIdパラメータ、BR-SESSION-005)、error-handling.md更新(ERR_2006 UNAUTHORIZED、UnauthorizedErrorクラス詳細) |
| 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 | 仕様正本化、検索中心に再設計 |
Score
Total Score
Based on repository quality metrics
SKILL.mdファイルが含まれている
ライセンスが設定されている
100文字以上の説明がある
GitHub Stars 100以上
3ヶ月以内に更新がある
10回以上フォークされている
オープンIssueが50未満
プログラミング言語が設定されている
1つ以上のタグが設定されている
Reviews
Reviews coming soon