PickSkill
← Back

aiworkflow-requirements

AIWorkflowOrchestratorプロジェクトの仕様管理スキル。 仕様書を検索・参照するためのインターフェース。 references/配下に全仕様を格納し、キーワード検索で必要な情報に素早くアクセス。 Anchors: • Specification-Driven Development / 適用: 仕様書正本 / 目的: 実装との一貫性 • Progressive Disclosure / 適用: 検索→詳細参照 / 目的: コンテキスト効率化 • MECE原則 / 適用: トピック分類 / 目的: 漏れなく重複なく Trigger: プロジェクト仕様の検索、アーキテクチャ確認、API設計参照、セキュリティ要件確認、テスト戦略参照を行う場合に使用。 仕様, 要件, アーキテクチャ, API, データベース, セキュリティ, UI/UX, デプロイ, Claude Code, テスト, MSW, カバレッジ, PermissionStore, 権限永続化, rememberChoice, SkillSlice, Zustand, 状態管理, skillSlice, リトライ, retry, backoff, Exponential Backoff, Jitter, RetryConfig, permissionHistory, PermissionHistoryPanel, PermissionHistorySlice, 権限履歴, 履歴トラッキング, safeArgsSnapshot, PermissionHistoryEntry, PermissionHistoryFilter, DatePreset, DateRangeFilter, dateFilterUtils, 期間フィルタ, コンポーネントテスト, Storeモック, フィクスチャ, アクセシビリティ, WCAG, userEvent, fireEvent, RTL, React Testing Library, jest-axe, ARIA, SkillStreamMessage, Discriminated Union, BaseStreamMessage, 型統合, skill-execution, ExecutionState, SkillExecutionRequest, session, refresh, token,

SKILL.md
Rendered from GitHub raw
View raw ↗

name: aiworkflow-requirements description: | AIWorkflowOrchestrator の正本仕様を references/ から検索・参照・更新するスキル。resource-map / quick-reference / topic-map / keywords を起点に必要最小限だけ読む。用途は要件確認、設計・API・IPC 契約確認、UI/状態管理/セキュリティ判断、task-workflow / lessons-learned / 未タスク同期。主要対象は safeInvoke timeout、settings bypass、skill lifecycle、global nav、Skill Center / Workspace / Agent / Skill Creator 導線再編。Anchors: Specification-Driven Development, Progressive Disclosure。Trigger: 仕様確認、仕様更新、task-workflow同期、lessons-learned同期、API/IPC契約確認、セキュリティ要件確認、safeInvoke、timeout、settings bypass、skill lifecycle、Skill Center、Workspace、Agent、Skill Creator、line budget reform、spec splitting、family split、ToolRiskLevel、SafetyGatePort、AllowedToolEntryV2、processPermissionFallback、executeAbortFlow、executeSkipFlow、DefaultSafetyGate、evaluateSafety、skill:evaluate-safety、ViewType、renderView、ビュー分岐、画面ルーティング、ApprovalGate、Consumer Auth Guard、isConsumerToken、sanitizeForApiKeys、approval:respond、approval:request、SessionDisclosureBanner、AdvancedConsolePanel、AdapterStatusBadge、RetryButton、LLMAdapterStatus、adapter status badge、リトライ導線、ApiKeysSection、health check、refreshAdapterStatuses、path-scoped enforcement、canUseTool 判定、extractTargetPath、allowedSkillRoot、createImproveGovernanceCanUseTool。 AIWorkflowOrchestrator の正本仕様を references/ から検索・参照・更新するスキル。resource-map / quick-reference / topic-map / keywords を起点に必要最小限だけ読む。用途は要件確認、設計・API・IPC 契約確認、UI/状態管理/セキュリティ判断、task-workflow / lessons-learned / 未タスク同期。主要対象は safeInvoke timeout、settings bypass、skill lifecycle、global nav、Skill Center / Workspace / Agent / Skill Creator 導線再編。Anchors: Specification-Driven Development, Progressive Disclosure。Trigger: 仕様確認、仕様更新、task-workflow同期、lessons-learned同期、API/IPC契約確認、セキュリティ要件確認、safeInvoke、timeout、settings bypass、skill lifecycle、Skill Center、Workspace、Agent、Skill Creator、line budget reform、spec splitting、family split、ToolRiskLevel、SafetyGatePort、AllowedToolEntryV2、processPermissionFallback、executeAbortFlow、executeSkipFlow、DefaultSafetyGate、evaluateSafety、skill:evaluate-safety、ViewType、renderView、ビュー分岐、画面ルーティング、ApprovalGate、Consumer Auth Guard、isConsumerToken、sanitizeForApiKeys、approval:respond、approval:request、SessionDisclosureBanner、AdvancedConsolePanel、AdapterStatusBadge、RetryButton、LLMAdapterStatus、adapter status badge、リトライ導線、ApiKeysSection、health check、refreshAdapterStatuses、PROVIDER_CONFIGS、provider-registry、gpt-5.4、claude-sonnet-4-6、gemini-3-flash-preview、grok-4-1-fast-non-reasoning、system_instruction、inferProviderId、ProviderModelEntry、OpenAICompatibleAdapter、OpenRouter、isAvailable、LLMModel、SdkOutputMessageBase、SkillExecutorStreamMessage、SkillExecutorStreamMessageType、型統合、出力型統合、SKILL_CREATOR_GET_ADAPTER_STATUS、SKILL_CREATOR_ADAPTER_STATUS_CHANGED、result-panel、SkillLifecyclePanel、SkillCreationResultPanel、orchestration wrapper、ui-result-panel-pattern、state owner、persist surface、verify retry surface、executeAsync、snapshot ?? null、variadic IPC、onWorkflowStateSnapshot、errorMessage propagation、multi-arg event、structured error path、catch path、SKILL_CREATOR_RUNTIME_CHANNELS、shared-ipc-channel SSoT、packages/shared/src/ipc/channels、cross-layer parity、governance-bundle.test、SkillInfoFormData、SkillCategory(wizard)、SkillWizardScheduleConfig、ConversationAnswers、SmartDefaultResult、SkeletonQualityFeedback、wizard-shared-contracts、subpath export、@repo/shared/types/skillCreator、UT-SKILL-WIZARD、skill-wizard-redesign-lane、UT-SKILL-WIZARD-W1-par-02d、onOpenSkillWizard、SkillLifecyclePanel ウィザード遷移ボタン化。 allowed-tools:

  • Read
  • Glob
  • Grep
  • Bash

AIWorkflow Requirements Manager

概要

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

クイックスタート

仕様を探す

# キーワード検索(推奨)
node scripts/search-spec.js "認証" -C 5
 
# または resource-map.md でタスク種別から逆引き

仕様を読む

  1. まず resource-map.md を確認 - タスク種別と current canonical set を特定
  2. 該当ファイルを Read ツールで参照
  3. 今回差分の完全ファイル一覧、旧 ordinal filename から current semantic filename への対応、エレガンス監査が必要な場合は workflow-aiworkflow-requirements-line-budget-reform-artifact-inventory.md, legacy-ordinal-family-register.md, spec-elegance-consistency-audit.md を参照
  4. 詳細行番号や完全ファイル一覧が必要な場合は topic-map.mdnode scripts/list-specs.js --topics を参照

仕様を作成・更新

  1. assets/ 配下の該当テンプレートを使用
  2. references/spec-guidelines.mdreferences/spec-splitting-guidelines.md を見て、classification-first で更新する
  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/UX ui-ux-components.md, ui-ux-design-principles.md, ui-history-*.md
セキュリティ security-principles.md, security-electron-ipc.md, csrf-state-parameter.md, security-*.md
技術スタック technology-core.md, technology-frontend.md, technology-desktop.md
Claude Code claude-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-structure resource-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 IPC IPC通信
react-hook-template.md React Hook カスタムフック
react-context-template.md React Context 状態管理
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 大規模ファイル分割ガイドライン
ui-result-panel-pattern.md ResultPanel コンポーネント設計パターン(ErrorBanner/DetailPanel/react.memo/local state 判断基準)— TASK-RT-03 確立
lessons-learned-skill-wizard-redesign.md Skill Wizard Redesign(W2-seq-03a)実装知見・SkillCreateWizard オーケストレーション・inferSmartDefaults・再入防止パターン

連携スキル

スキル 用途
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行超過時は classification-first で parent / child / history / archive / discovery を同一 wave で分割

避けるべきこと

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