jpskill.com
🛠️ 開発・MCP コミュニティ

spec-kit-constitution

Spec Kitプロジェクトの憲章を作成・修正する際に、特に憲章ファイルがない、プレースホルダーがある、または計画・仕様・タスクのテンプレートに原則的な変更を反映させる必要がある場合に活用するSkill。

📜 元の英語説明(参考)

Use when creating or amending a Spec Kit project constitution, especially when `memory/constitution.md` is missing, contains `[PLACEHOLDER]` tokens, or principle changes must be propagated to planning/spec/task templates.

🇯🇵 日本人クリエイター向け解説

一言でいうと

Spec Kitプロジェクトの憲章を作成・修正する際に、特に憲章ファイルがない、プレースホルダーがある、または計画・仕様・タスクのテンプレートに原則的な変更を反映させる必要がある場合に活用するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o spec-kit-constitution.zip https://jpskill.com/download/10648.zip && unzip -o spec-kit-constitution.zip && rm spec-kit-constitution.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/10648.zip -OutFile "$d\spec-kit-constitution.zip"; Expand-Archive "$d\spec-kit-constitution.zip" -DestinationPath $d -Force; ri "$d\spec-kit-constitution.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して spec-kit-constitution.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → spec-kit-constitution フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Spec Kit Constitution

プロジェクトの憲章を作成または修正し、依存するテンプレートを整合性を保ちます。

使用するタイミング

  • ユーザーが Spec Kit プロジェクトの最初の憲章の作成を依頼した場合。
  • ユーザーがガバナンス/原則を修正し、憲章のバージョン管理を更新することを依頼した場合。
  • memory/constitution.md が存在しないか、まだ [PLACEHOLDER] トークンを含んでいる場合。
  • 原則の変更を計画/仕様/タスクのテンプレートに反映する必要がある場合。

ルーターの適合性

  • 意図がガバナンス/原則である場合、spec-kit からの主要なルート。
  • 憲法上の規則が変更された場合、機能計画の前に実行します。
  • ダウンストリームの依存関係: spec-kit-plan の憲章チェックはこの出力に依存します。

前提条件

  • ターゲットプロジェクトのリポジトリルートから作業します。
  • memory/constitution.md が作成されたら、それを信頼できる情報源として扱います。

ワークフロー

  1. 憲章ファイルを解決します。
    • ターゲット: {REPO_ROOT}/memory/constitution.md。
    • 存在しない場合は、{REPO_ROOT}/templates/constitution-template.md が存在する場合はそこから初期化します。それ以外の場合は、assets/constitution-template.md を使用します。
  2. 既存の憲章からベースラインの状態をキャプチャします（存在する場合）。
    • 現在のバージョン。
    • 批准日と最終修正日。
    • 差分レポート用の原則/セクションのタイトル。
    • 未解決の [PLACEHOLDER] トークン。
  3. 必要な値を、まずユーザー入力から、次にリポジトリのコンテキストから入力します。
    • 重要なデータが不明な場合は、TODO(<FIELD_NAME>): <reason> を使用します。
  4. セマンティックバージョンのバンプと日付を決定します。
    • MAJOR: 後方互換性のないガバナンス/原則の再定義または削除。
    • MINOR: 新しい原則/セクションまたは実質的に拡張されたポリシー。
    • PATCH: 明確化、言い回し、タイプミス、非セマンティックな改善。
    • RATIFICATION_DATE: 元の採用日を保持します。
    • LAST_AMENDED_DATE: コンテンツが変更された場合にのみ、今日の日付 (YYYY-MM-DD) に設定します。
  5. 憲章を起草します。
    • プレースホルダーを具体的なポリシーテキストに置き換えます。
    • テンプレートからの見出しの階層を保持します。
    • 原則を宣言的かつテスト可能にします（根拠のある MUST/SHOULD）。
    • ガバナンスは、修正プロセス、バージョン管理ポリシー、およびコンプライアンスレビューについて明示的に記述します。
  6. ポリシーの変更を、ターゲットリポジトリ内の依存するテンプレートに反映します（存在する場合）。
    • templates/plan-template.md
    • templates/spec-template.md
    • templates/tasks-template.md 改訂された原則に合わせて、憲法上のチェック、必要なセクション、およびタスクの期待値を更新します。
  7. Sync Impact Report の HTML コメントを memory/constitution.md の先頭に追加します。これには以下が含まれます。
    • バージョンの変更 (old -> new)。
    • 変更された原則（名前の変更を含む）。
    • 追加/削除されたセクション。
    • テンプレートの同期ステータス（updated vs pending）とファイルパス。
    • 保留中の TODO 項目。
  8. 確定前に検証します。
    • 説明のない角括弧のプレースホルダーが残っていないこと。
    • バージョン/日付の行がレポートと一致し、YYYY-MM-DD 形式を使用していること。
    • ファイルパスが memory/constitution.md であること（/memory/constitution.md ではない）。
  9. memory/constitution.md を書き込み、結果をユーザーに報告します。

出力

  • 更新された memory/constitution.md。
  • テンプレートファイルが存在し、必要な場合は更新されます。
  • バージョンバンプの根拠、保留中のフォローアップ、および推奨されるコミットメッセージを含む概要。

よくある間違い

  • 依存するテンプレートを更新せずに原則を更新すること。
  • マイナー/メジャーバンプが必要な重要なポリシー変更にパッチバンプを使用すること。
  • 明示的な TODO アノテーションなしで未解決のプレースホルダーを残すこと。
  • memory/constitution.md ではなく /memory/constitution.md に書き込むこと。

参考文献

  • Spec Kit シーケンスにおける憲章作業の位置については、references/spec-kit-workflow.dot を参照してください。
  • assets/constitution-template.md
  • assets/spec-template.md
  • assets/plan-template.md
  • assets/tasks-template.md
  • https://github.com/github/spec-kit/blob/9111699cd27879e3e6301651a03e502ecb6dd65d/templates/commands/constitution.md
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Spec Kit Constitution

Create or amend the project constitution and keep dependent templates aligned.

When to Use

  • User asks to create the first constitution for a Spec Kit project.
  • User asks to amend governance/principles and update constitution versioning.
  • memory/constitution.md is missing or still contains [PLACEHOLDER] tokens.
  • Principle changes must be propagated into planning/spec/task templates.

Router Fit

  • Primary route from spec-kit when intent is governance/principles.
  • Run before feature planning when constitutional rules changed.
  • Downstream dependency: spec-kit-plan constitution checks rely on this output.

Preconditions

  • Work from the target project repository root.
  • Treat memory/constitution.md as the source of truth once created.

Workflow

  1. Resolve constitution file:
    • Target: {REPO_ROOT}/memory/constitution.md.
    • If missing, initialize from {REPO_ROOT}/templates/constitution-template.md when present; otherwise use assets/constitution-template.md.
  2. Capture baseline state from existing constitution (if present):
    • Current version.
    • Ratified and last amended dates.
    • Principle/section titles for diff reporting.
    • Any unresolved [PLACEHOLDER] tokens.
  3. Fill required values from user input first, then repository context.
    • If critical data is unknown, use TODO(<FIELD_NAME>): <reason>.
  4. Decide semantic version bump and dates:
    • MAJOR: backward-incompatible governance/principle redefinition or removal.
    • MINOR: new principle/section or materially expanded policy.
    • PATCH: clarifications, wording, typo, non-semantic refinements.
    • RATIFICATION_DATE: keep original adoption date.
    • LAST_AMENDED_DATE: set to today (YYYY-MM-DD) only when content changes.
  5. Draft the constitution:
    • Replace placeholders with concrete policy text.
    • Keep heading hierarchy from the template.
    • Make principles declarative and testable (MUST/SHOULD with rationale).
    • Keep Governance explicit about amendment process, versioning policy, and compliance review.
  6. Propagate policy changes to dependent templates in the target repo when present:
    • templates/plan-template.md
    • templates/spec-template.md
    • templates/tasks-template.md Update constitutional checks, required sections, and task expectations to match revised principles.
  7. Prepend a Sync Impact Report HTML comment to memory/constitution.md containing:
    • Version change (old -> new).
    • Modified principles (including renames).
    • Added/removed sections.
    • Template sync status (updated vs pending) with file paths.
    • Deferred TODO items.
  8. Validate before finalizing:
    • No unexplained bracket placeholders remain.
    • Version/date line matches report and uses YYYY-MM-DD format.
    • File path is memory/constitution.md (not /memory/constitution.md).
  9. Write memory/constitution.md and report results to the user.

Output

  • Updated memory/constitution.md.
  • Updated template files when present and required.
  • Summary including version bump rationale, pending follow-ups, and a suggested commit message.

Common Mistakes

  • Updating principles without updating dependent templates.
  • Using a patch bump for material policy changes that require a minor/major bump.
  • Leaving unresolved placeholders without explicit TODO annotations.
  • Writing to /memory/constitution.md instead of memory/constitution.md.

References

  • references/spec-kit-workflow.dot for where constitution work fits in the Spec Kit sequence.
  • assets/constitution-template.md
  • assets/spec-template.md
  • assets/plan-template.md
  • assets/tasks-template.md
  • https://github.com/github/spec-kit/blob/9111699cd27879e3e6301651a03e502ecb6dd65d/templates/commands/constitution.md