OpenSkillIndex← back to search
claude-codeproductivity

Claude-skill-registry aiworkflow-requirements

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/aiworkflow-requirements" ~/.claude/skills/majiayu000-claude-skill-registry-aiworkflow-requirements && rm -rf "$T"
manifest: skills/data/aiworkflow-requirements/SKILL.md
tags
#document-search#code-documentation#grep#file-management#specification-management
source content

AIWorkflow Requirements Manager

概要

AIWorkflowOrchestratorプロジェクトの全仕様を管理するスキル。 このスキルが仕様の正本であり、references/配下のドキュメントを直接編集・参照する。

クイックスタート

仕様を探す

# キーワード検索（推奨）
node scripts/search-spec.js "認証" -C 5

# または resource-map.md でタスク種別から逆引き

仕様を読む

  1. まず resource-map.md を確認 - タスク種別に応じた読み込みファイルを特定
  2. 該当ファイルを 
    Read
    ツールで参照
  3. 詳細行番号が必要な場合は topic-map.md を参照

仕様を作成・更新

  1. assets/
    配下の該当テンプレートを使用
  2. references/spec-guidelines.md
    の命名規則に従う
  3. 編集後は 
    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/UXui-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 Codeclaude-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-structureresource-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 IPCIPC通信
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

変更履歴

VersionDateChanges
8.6.02026-01-26仕様ガイドライン完全準拠: 全134ファイル（133ファイルコードブロック除去完了、spec-guidelines.md除く）のspec-guidelines.md準拠修正。82参照ファイルのTypeScript/JSON/SQL/ASCIIダイアグラムを表形式・文章に変換
8.5.02026-01-26仕様ガイドライン準拠修正: architecture-overview.md/technology-desktop.md（ディレクトリ構造を表形式化）、development-guidelines.md/architecture-implementation-patterns.md（コード例を表形式・文章に変換）、templates全11種（コード例を表形式に変換）
8.4.02026-01-26実装パターン総合ガイド追加: architecture-implementation-patterns.md新規作成（フロントエンド/バックエンド/デスクトップ/パフォーマンス/セキュリティ/テスト/アクセシビリティ実装パターン網羅）
8.3.02026-01-26開発ガイドライン拡充: development-guidelines.md v1.1.0（命名規則、デバッグガイド、リリースプロセス、バックアップ・リカバリ、環境構築ガイド追加）
8.2.02026-01-26UX法則・開発ガイドライン追加: ui-ux-design-principles.mdにUXデザイン法則（Fitts, Hick, Jakob, Miller, Gestalt, Progressive Disclosure等）追加、development-guidelines.md新規作成（ロギング、キャッシング、マイグレーション、コードレビュー、i18n）
8.1.02026-01-26アーキテクチャ総論追加: architecture-overview.md新規作成、technology-frontend.md/technology-desktop.md追加、templates/ディレクトリ新設（テンプレート11種）
8.0.02026-01-26大規模リファクタリング: 94→129ファイル拡張（+35分割ファイル）、resource-map.md全ファイル網羅（v1.2.0）、エージェント3件v2.1.0更新、Progressive Disclosure原則に基づくインデックス最適化
7.2.02026-01-26エージェント改善: create-spec/update-spec/validate-spec v2.0.0更新（16テンプレート対応、select-template.js統合、quick-reference.md/resource-map.md参照追加、テンプレート準拠検証ワークフロー追加）
7.1.02026-01-26追加最適化: 16種テンプレート（ipc-channel, react-hook, service, error-handling, testing追加）、quick-reference.md新設、indexes/セクション強化
7.0.02026-01-26スキルリファクタリング: 11種テンプレート追加、interfaces-agent-sdk.md分割（6ファイル）、resource-map.md新設（読み込み条件付き）、spec-splitting-guidelines.md追加、SKILL.mdクイックスタート追加。94ファイル・11カテゴリ構成に拡張
6.31.02026-01-26TASK-3-1-E完了: security-skill-execution.mdにPermission Storeセクション追加、ui-ux-settings.mdにPermissionSettings UI追加、interfaces-agent-sdk.md更新。159テスト・96%カバレッジ達成
6.30.02026-01-26TASK-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%カバレッジ
6.29.02026-01-26TASK-3-1-D完了: interfaces-agent-sdk.md v2.3.0更新（skillAPI.onPermission/respondPermission、useSkillPermission Hook、型定義）、security-api-electron.md更新（IPC channels、テストカバレッジ）。124テスト・100%カバレッジ
6.28.02026-01-25TASK-3-2完了: security-api-electron.mdにSkill Execution Preload APIセキュリティセクション追加（IPCチャンネル4種、ホワイトリスト、ストリーミングセキュリティ、React Hook統合）。138テスト・100%カバレッジ
6.27.02026-01-25UI-CONV-HISTORY-001完了: interfaces-chat-history.md v1.2.0更新（Renderer Process型定義、Preload API、React Hooks、UIコンポーネント構成、アクセシビリティ対応）。280テスト・98.66%カバレッジ達成
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:list
→
skill: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:execute
IPC/
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.js追加
5.0.02026-01-04SKILL.md軽量化、詳細をindexes/references/へ分離
4.0.02026-01-03kebab-case化、大ファイル分割、47ファイル構成
3.0.02026-01-03仕様正本化、検索中心に再設計