本文へ移動
cccskills
無料GitHub で公開

skill-phase-formatter

Use when splitting a domain Skill into Phase-Aware File Structure (SKILL.md / design.md / constraints.md). Defines the splitting criteria, procedures, sync procedures, and validation rules. Invoked by /skill-format command or manually when restructuring domain Skills.

インストール方法を見る

含まれるファイル(1)

  • SKILL.md3.5 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Skill Phase Formatter

ドメイン Skill を Phase-Aware File Structure に分割・同期するための方法論。

SSOT 原則

  • SKILL.md がマスター(Single Source of Truth)
  • design.md / constraints.md は SKILL.md の部分集合
  • 派生ファイルにのみ存在する知識は禁止
  • 新しい知識はまず SKILL.md に追加し、必要に応じて派生ファイルに反映

分割基準

constraints.md に含めるもの

  • 技術的にできないこと(ランタイム制約、API 制限、互換性制約)
  • 数値的な上限・下限
  • 前提条件
  • 禁止事項(理由なし、事実のみ)
  • 目安: 20-30行以内

design.md に含めるもの

  • パターン選択の判断基準
  • トレードオフの説明
  • 非機能要件の考慮事項
  • アンチパターンとその理由
  • 目安: 80-120行以内

design.md に含めないもの

  • 具体的なコード例(コードブロック)
  • ステップバイステップの実装手順
  • API リファレンス的な詳細

ヘッダー規約

  • constraints.md: # <skill-name>: 技術的制約
  • design.md: # <skill-name>: 設計ガイダンス

分割手順

  1. 対象 Skill の SKILL.md を全文読み込む
  2. 技術的制約に該当する記述を抽出 → constraints.md として整形
  3. 設計指針・パターン選択基準に該当する記述を抽出 → design.md として整形
  4. 抽出した内容が SKILL.md の部分集合であることを確認
  5. 行数制限を確認(constraints.md ≤ 30行、design.md ≤ 120行)
  6. design.md にコードブロックが含まれていないことを確認

同期手順

SKILL.md が更新された場合、派生ファイルを同期する:

  1. SKILL.md の変更差分を確認
  2. 変更が制約に影響するか判定 → 影響あれば constraints.md を更新
  3. 変更が設計指針に影響するか判定 → 影響あれば design.md を更新
  4. 更新後の派生ファイルが SKILL.md の部分集合であることを再確認
  5. 行数制限を再確認
  6. design.md / constraints.md が存在しない Skill は同期対象外(新規生成は行わない)

検証項目

分割後に以下を全て確認する:

  • constraints.md が30行以内である
  • design.md が120行以内である
  • design.md にコードブロック(```)が含まれていない
  • constraints.md の全内容が SKILL.md に存在する(部分集合)
  • design.md の全内容が SKILL.md に存在する(部分集合)
  • constraints.md のヘッダーが # <skill-name>: 技術的制約 である
  • design.md のヘッダーが # <skill-name>: 設計ガイダンス である

分割対象の判定

以下に該当する Skill は分割対象外:

  • 方法論 Skill(フェーズ固有の知識差がない)
  • ユーティリティ Skill
  • 50行以下の軽量 Skill
  • テスト専用 Skill
  • UI/デザイン専用 Skill(実装寄りの知識が主体)

Applicability

  • フェーズ: documentation, design, spec(Skill のメンテナンス時)
  • ドメイン: universal(全ドメイン Skill に適用)

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Use at the START of every task, before writing any code, running tests, debugging, reviewing, or designing. This skill determines which methodology and domain skills must be invoked. MUST be invoked before any implementation, debugging, review, testing, or specification work begins.

日本語の概要は準備中です。原文の説明を表示しています。

kousukef/forge152026年4月6日 更新

Pattern for progressively refining context retrieval to solve the subagent context problem

日本語の概要は準備中です。原文の説明を表示しています。

kousukef/forge152026年4月6日 更新

proposal-readiness-check

無料日本語概要

proposal.md が /spec の入力として十分な情報を含んでいるかを確認する。「ユーザーにとっての承認」ではなく「/spec にとっての準備完了度」を検証する軽量チェック

kousukef/forge152026年4月6日 更新

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, update or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

日本語の概要は準備中です。原文の説明を表示しています。

kousukef/forge152026年4月6日 更新

story-quality-gate

無料日本語概要

/brainstorm のユーザーストーリー品質を INVEST 基準で軽量チェックする。proposal.md 生成前にストーリーの構造的品質を確認し、問題があれば対話で改善を促す

kousukef/forge152026年4月6日 更新

Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.

日本語の概要は準備中です。原文の説明を表示しています。

kousukef/forge152026年4月6日 更新

kousukef のスキルをすべて見る

このスキルの問題を報告する