grace-init について
grace-initはテンプレートを使い、GRACE 4の標準的なコンテキスト、グラフ、検証ファイルと変更用ディレクトリを作成します。GRACEを導入するプロジェクト向けで、確認なしに既存ファイルを上書きしません。
主な機能
- 01標準GRACE 4ファイルの作成
- 02テンプレートによるXMLファイルの生成
- 03コンテキスト・グラフ・検証構成の作成
- 04確認なしでの既存内容の上書き防止
- 05利用可能な場合のgrace lint検証
活用シーン
- 01プロジェクトへのGRACE構成の初期導入
- 02コンテキストと検証テンプレートの追加
- 03アクティブ・アーカイブ変更用ディレクトリの設定
MCP 対応
このスキルは、グラフ、検証、変更用ディレクトリを含むGRACE向けのプロジェクトファイルを初期化します。CLIが利用可能な場合、GRACE CLIによる検証を推奨します。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ osovv/ grace-marketplace --skill grace-initインストール後、Claude Code で/grace-initを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlassets/AGENTS.md.templateassets/.grace/context/deployment.xml.templateprinciples.xml.templaterequirements.xml.templatetechnology.xml.templateux-guidelines.xml.templateassets/.grace/graph/index.xml.templatemain.xml.templateassets/.grace/verification/index.xml.templatemain.xml.template詳細
このスキルの`assets/`テンプレートから、GRACE 4の標準プロジェクトレイアウトを作成します。
1. プロジェクト名、注釈、キーワード、言語/ランタイム/フレームワーク、テストスタック、可観測性の制約、デプロイの適用可否、UXの適用可否、既知の初期モジュールを収集します。
2. `.grace`または`AGENTS.md`がすでに存在する場合は停止し、既存の各成果物を保持、マージ、上書きのいずれにするかを尋ねます。黙って上書きしてはいけません。
3. `.grace/context`、`.grace/graph`、`.grace/verification`、`.grace/changes/active`、`.grace/changes/archive`を作成します。
4. 各`.template`ファイルを読み込み、`$PLACEHOLDER`の値を収集したプロジェクト情報に置き換えて、対象ファイルに書き込みます。
5. 作成したファイルを表示し、次のワークフローとして、`grace-spec`でアクティブな`GraceChangeSpec`を作成し、実装前に`grace-plan`で`GraceChangePlan`を生成することを推奨します。
AGENTS.md.grace/context/requirements.xml.grace/context/technology.xml.grace/context/principles.xml.grace/context/deployment.xml.grace/context/ux-guidelines.xml.grace/graph/index.xml.grace/graph/main.xml.grace/verification/index.xml.grace/verification/main.xml.grace/changes/active/.grace/changes/archive/
すべてのXML成果物でgraceVersion="4.0"を使用します。意味上のアンカーには属性ではなくXMLタグを使用します。ダミーのC-*変更バンドルは作成しません。明示的な確認なしに既存の.grace成果物を上書きしません。
<template_sources>
| テンプレートソース | プロジェクト内の配置先 |
|---|---|
assets/AGENTS.md.template | AGENTS.md |
assets/.grace/context/requirements.xml.template | .grace/context/requirements.xml |
assets/.grace/context/technology.xml.template | .grace/context/technology.xml |
assets/.grace/context/principles.xml.template | .grace/context/principles.xml |
assets/.grace/context/deployment.xml.template | .grace/context/deployment.xml |
assets/.grace/context/ux-guidelines.xml.template | .grace/context/ux-guidelines.xml |
assets/.grace/graph/index.xml.template | .grace/graph/index.xml |
assets/.grace/graph/main.xml.template | .grace/graph/main.xml |
assets/.grace/verification/index.xml.template | .grace/verification/index.xml |
assets/.grace/verification/main.xml.template | .grace/verification/main.xml |
| </template_sources> |
<hard_rules>
- GRACE 4の状態は
.grace配下に保存します。ブートストラップの場所として従来のdocs/*.xmlを作成してはいけません。 GraceChangeSpecとGraceChangePlanは後続の変更ワークフローで作成するものであり、初期化では作成しません。- 従来のGRACE 3ドキュメントが存在する場合は、移行は
grace-migrateでのみ行うことを説明します。initで変換または削除してはいけません。 - CLIが使用可能な場合は、
grace lint --path <project-root>で生成後のプロジェクトを検証します。 </hard_rules>
コメント
Markdown 対応