aiworkflow-requirements
AIWorkflowOrchestratorプロジェクトの仕様管理スキル。 仕様書を検索・参照するためのインターフェース。 references/配下に全仕様を格納し、キーワード検索で必要な情報に素早くアクセス。 Anchors: • Specification-Driven Development / 適用: 仕様書正本 / 目的: 実装との一貫性 • Progressive Disclosure / 適用: 検索→詳細参照 / 目的: コンテキスト効率化 • MECE原則 / 適用: トピック分類 / 目的: 漏れなく重複なく Trigger: プロジェクト仕様の検索、アーキテクチャ確認、API設計参照、セキュリティ要件確認、テスト戦略参照を行う場合に使用。 仕様, 要件, アーキテクチャ, API, データベース, セキュリティ, UI/UX, デプロイ, Claude Code, テスト, MSW, カバレッジ
|
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 | 構造検証 | 週次/リリース前 | 全体 | 検証レポート |
リソース参照
仕様ファイル一覧
48ファイル・10トピック: See indexes/topic-map.md
| トピック | ファイル数 |
|---|---|
| 概要・品質 | 4 |
| アーキテクチャ | 6 |
| インターフェース | 6 |
| API設計 | 3 |
| データベース | 3 |
| UI/UX | 5 |
| セキュリティ | 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.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 | 仕様正本化、検索中心に再設計 |
You Might Also Like
Related Skills
update-docs
This skill should be used when the user asks to "update documentation for my changes", "check docs for this PR", "what docs need updating", "sync docs with code", "scaffold docs for this feature", "document this feature", "review docs completeness", "add docs for this change", "what documentation is affected", "docs impact", or mentions "docs/", "docs/01-app", "docs/02-pages", "MDX", "documentation update", "API reference", ".mdx files". Provides guided workflow for updating Next.js documentation based on code changes.
vercel
docstring
Write docstrings for PyTorch functions and methods following PyTorch conventions. Use when writing or updating docstrings in PyTorch code.
pytorch
docs-writer
Always use this skill when the task involves writing, reviewing, or editing files in the `/docs` directory or any `.md` files in the repository.
google-gemini
write-concept
Write or review JavaScript concept documentation pages for the 33 JavaScript Concepts project, following strict structure and quality guidelines
leonardomsoresource-curator
Find, evaluate, and maintain high-quality external resources for JavaScript concept documentation, including auditing for broken and outdated links
leonardomso
doc-coauthoring
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.
anthropics