kuroco-spec-writer
Installation
SKILL.md
Kuroco 仕様書ジェネレーター(Admin MCP)
概要
Admin MCP の読み取り系ツールのみでKurocoサイトの実設定を収集し、 references/template.md の構成で Markdown + Mermaid の仕様書一式を生成する。 実装(実設定)を一次情報にするため、手書きの仕様書と違って現物と乖離しない。
| 本スキルの範囲 | 範囲外 |
|---|---|
| 実設定からの現況仕様書の生成(主要章=コンテンツ定義・API・認証・ワークフロー・カスタム処理・フォーム+そのサイトで使われている他モジュール) | 設定の変更(本スキルでは行わない。変更は /kuroco-admin-mcp に切り替え、ユーザー承認のうえ実施) |
| ER図・シーケンス図・状態遷移図・フローチャートによる構造の可視化 | セキュリティ観点のリスク判定(→ /kuroco-security-audit) |
| 機械可読な定義ファイルの同梱(API の OpenAPI 3.1.0 と、コンテンツ定義の生レスポンス。→ 機械可読な定義ファイル) | 定義ファイルを使った他サイトへの複製・移行(読み取って保存するところまで。投入は /kuroco-content-structure) |
| PDF + zip への変換(scripts/build-pdf.mjs、ローカル実行環境のみ) | フロントエンド実装コードの仕様化(リポジトリがあればコードから別途起こす) |
| 編集された仕様書の解釈と差分計画の提示(→ 仕様書からの反映) | 反映の書き込み実行(/kuroco-admin-mcp 等の規約・承認フローに従う) |