aiworkflow-requirements

aiworkflow-requirements

AIWorkflowOrchestratorプロジェクトの仕様管理スキル。 仕様書を検索・参照するためのインターフェース。 references/配下に全仕様を格納し、キーワード検索で必要な情報に素早くアクセス。 Anchors: • Specification-Driven Development / 適用: 仕様書正本 / 目的: 実装との一貫性 • Progressive Disclosure / 適用: 検索→詳細参照 / 目的: コンテキスト効率化 • MECE原則 / 適用: トピック分類 / 目的: 漏れなく重複なく Trigger: プロジェクト仕様の検索、アーキテクチャ確認、API設計参照、セキュリティ要件確認、テスト戦略参照を行う場合に使用。 仕様, 要件, アーキテクチャ, API, データベース, セキュリティ, UI/UX, デプロイ, Claude Code, テスト, MSW, カバレッジ

4Star
0Fork
更新于 1/22/2026
SKILL.md
readonly只读
name
aiworkflow-requirements
description

|

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

update-docs

137Kdev-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 avatarvercel
获取
docstring

docstring

97Kdev-docs

Write docstrings for PyTorch functions and methods following PyTorch conventions. Use when writing or updating docstrings in PyTorch code.

pytorch avatarpytorch
获取
docs-writer

docs-writer

94Kdev-docs

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 avatargoogle-gemini
获取
write-concept

write-concept

66Kdev-docs

Write or review JavaScript concept documentation pages for the 33 JavaScript Concepts project, following strict structure and quality guidelines

leonardomso avatarleonardomso
获取
resource-curator

resource-curator

66Kdev-docs

Find, evaluate, and maintain high-quality external resources for JavaScript concept documentation, including auditing for broken and outdated links

leonardomso avatarleonardomso
获取
doc-coauthoring

doc-coauthoring

47Kdev-docs

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 avataranthropics
获取