Communityライティング&編集github.com

loki-ai-ch/spec-manager

ローカルファーストの仕様駆動開発プラットフォーム。純粋なMarkdown + Gitストレージ。L0/L1/L2/L3仕様階層、24の検証ルール、エージェントタスクライフサイクル、意思決定カード、差分変更に対応。CLI + Claude Codeスキル。ネットワーク不要、MCP不要、バックエンド不要。

spec-manager とは?

loki-ai-ch/spec-managerは、ローカル環境に特化した仕様駆動開発を実現するためのプラットフォーム兼Claude Codeスキルです。すべての仕様情報を純粋なMarkdownファイルとしてGitリポジトリに保存するため、ネットワーク接続や外部バックエンド、MCPサーバーは一切不要で、完全にオフラインで動作します。このツールは、L0(概念)からL3(詳細実装)までの4段階の仕様階層を定義し、24種類の検証ルールによって仕様の一貫性と完全性を自動チェックします。また、エージェントタスクのライフサイクル管理、意思決定カードによるトレーサビリティ、そして変更差分(デルタ)の追跡機能を備えており、AIエージェント(Claude Code)とCLIの両方から利用可能です。開発者は、このスキルを使うことで、仕様の策定から検証、タスク管理までを一貫してローカル環境で行え、チーム全体での仕様の整合性と透明性を高めることができます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add loki-ai-ch/spec-manager

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

spec-manager は何をしますか?

ローカルファーストの仕様駆動開発プラットフォーム。純粋なMarkdown + Gitストレージ。L0/L1/L2/L3仕様階層、24の検証ルール、エージェントタスクライフサイクル、意思決定カード、差分変更に対応。CLI + Claude Codeスキル。ネットワーク不要、MCP不要、バックエンド不要。

概要

loki-ai-ch/spec-managerは、ローカル環境で動作する仕様駆動開発(Spec-Driven Development)を実現するためのツールです。すべての仕様情報を純粋なMarkdownファイルとしてGitリポジトリに保存し、ネットワーク接続や外部バックエンド、MCPサーバーに依存しません。

主な機能

L0/L1/L2/L3 仕様階層

仕様を4つの階層に分類して管理します。

  • L0(概念): プロジェクトのビジョン、目的、主要な概念を定義
  • L1(アーキテクチャ): システム全体の構造、コンポーネント間の関係を定義
  • L2(設計): 各コンポーネントの詳細設計、インターフェースを定義
  • L3(実装詳細): 実際の実装手順、テストケースを定義

24の検証ルール

仕様の一貫性と完全性を自動チェックする24種類の検証ルールを備えています。

エージェントタスクライフサイクル

AIエージェント(Claude Code)向けのタスクライフサイクル管理機能。タスクの作成、割り当て、進行中、完了、レビューといった状態を追跡します。

意思決定カード

プロジェクト内での重要な意思決定を記録・追跡するためのカードシステム。誰が、いつ、なぜその決定を下したかを明確にします。

差分変更(デルタ変更)

仕様の変更履歴を差分として追跡し、どの部分がいつ変更されたかを明確にします。

使用方法

CLIとして

# 仕様の初期化
spec-manager init

# 仕様の検証
spec-manager validate

# タスクの作成
spec-manager task create "タスク名"

# 意思決定カードの追加
spec-manager decision add "決定内容"

Claude Codeスキルとして

このツールはClaude Codeのスキルとしても利用可能です。設定ファイルに以下のように追加します。

{
  "skills": [
    "loki-ai-ch/spec-manager"
  ]
}

システム要件

  • ネットワーク: 不要(オフライン完全動作)
  • MCP: 不要
  • バックエンド: 不要
  • ストレージ: Git + ローカルファイルシステム
  • 形式: 純粋なMarkdown

インストール

npm install -g loki-ai-ch/spec-manager
# またはnpx経由
npx loki-ai-ch/spec-manager init

ライセンス

MIT

関連スキル