@einja/dev-cli 0.1.38 → 0.1.39

package/presets/default/.claude/skills/einja-skill-creator/scripts/init_skill.py

@@ -0,0 +1,333 @@
+#!/usr/bin/env python3
+"""
+Skill初期化スクリプト - テンプレートから新しいSkillを作成
+
+使用法:
+    init_skill.py <skill-name> --path <output-directory>
+
+例:
+    init_skill.py einja-my-new-skill --path .claude/skills
+    init_skill.py einja-api-helper --path .claude/skills
+    init_skill.py custom-skill --path /custom/location
+"""
+
+import sys
+from pathlib import Path
+
+
+SKILL_TEMPLATE = """---
+name: {skill_name}
+description: [TODO: このSkillが何をするか、いつ使用すべきかについての完全かつ有益な説明。特定のシナリオ、ファイルタイプ、またはトリガーとなるタスクを含めてください。]
+---
+
+# {skill_title}
+
+## 概要
+
+[TODO: このSkillが可能にすることについての1-2文の説明]
+
+## Skillの構造化
+
+[TODO: このSkillの目的に最適な構造を選択してください。一般的なパターン:
+
+**1. ワークフローベース**（順次プロセスに最適）
+- 明確なステップバイステップの手順がある場合に適している
+- 例: DOCXスキルの「ワークフロー決定ツリー」→「読み込み」→「作成」→「編集」
+- 構造: ## 概要 → ## ワークフロー決定ツリー → ## ステップ1 → ## ステップ2...
+
+**2. タスクベース**（ツールコレクションに最適）
+- Skillが異なる操作/機能を提供する場合に適している
+- 例: PDFスキルの「クイックスタート」→「PDFを結合」→「PDFを分割」→「テキストを抽出」
+- 構造: ## 概要 → ## クイックスタート → ## タスクカテゴリ1 → ## タスクカテゴリ2...
+
+**3. リファレンス/ガイドライン**（標準や仕様に最適）
+- ブランドガイドライン、コーディング規約、要件に適している
+- 例: ブランドスタイリングの「ブランドガイドライン」→「カラー」→「タイポグラフィ」→「機能」
+- 構造: ## 概要 → ## ガイドライン → ## 仕様 → ## 使用方法...
+
+**4. 機能ベース**（統合システムに最適）
+- Skillが複数の関連機能を提供する場合に適している
+- 例: プロダクト管理の「コア機能」→ 番号付き機能リスト
+- 構造: ## 概要 → ## コア機能 → ### 1. 機能 → ### 2. 機能...
+
+パターンは必要に応じて混在させて使用できます。ほとんどのSkillはパターンを組み合わせます（例: タスクベースで始め、複雑な操作にはワークフローを追加）。
+
+完了したら、この「Skillの構造化」セクション全体を削除してください - これは単なるガイダンスです。]
+
+## [TODO: 選択した構造に基づいて最初のメインセクションに置き換えてください]
+
+[TODO: ここにコンテンツを追加してください。既存のSkillの例を参照:
+- 技術的なSkillのためのコードサンプル
+- 複雑なワークフローのための決定ツリー
+- 現実的なユーザーリクエストを含む具体例
+- 必要に応じてscripts/templates/referencesへの参照]
+
+## リソース
+
+このSkillには、異なるタイプのバンドルリソースをどのように整理するかを示す例のリソースディレクトリが含まれています：
+
+### scripts/
+特定の操作を実行するために直接実行できる実行可能コード（Python/Bash等）。
+
+**他のSkillからの例:**
+- PDFスキル: `fill_fillable_fields.py`, `extract_form_field_info.py` - PDF操作のためのユーティリティ
+- DOCXスキル: `document.py`, `utilities.py` - ドキュメント処理のためのPythonモジュール
+
+**適切な用途:** Pythonスクリプト、シェルスクリプト、または自動化、データ処理、特定の操作を実行する実行可能コード。
+
+**注意:** スクリプトはコンテキストに読み込まずに実行できますが、パッチや環境調整のためにClaudeによって読まれる場合があります。
+
+例のリソースディレクトリを作成：`scripts/`、`references/`、`assets/`
+
+### references/
+Claudeの処理と思考を導くためにコンテキストに読み込まれることを意図したドキュメントと参照資料。
+
+**他のSkillからの例:**
+- プロダクト管理: `communication.md`, `context_building.md` - 詳細なワークフローガイド
+- BigQuery: APIリファレンスドキュメントとクエリ例
+- 財務: スキーマドキュメント、会社ポリシー
+
+**適切な用途:** 詳細なドキュメント、APIリファレンス、データベーススキーマ、包括的なガイド、またはClaudeが作業中に参照すべき詳細情報。
+
+### assets/
+コンテキストに読み込まれることを意図せず、Claudeが生成する出力で使用されるファイル。
+
+**他のSkillからの例:**
+- ブランドスタイリング: PowerPointテンプレートファイル (.pptx), ロゴファイル
+- フロントエンドビルダー: HTML/Reactボイラープレートプロジェクトディレクトリ
+- タイポグラフィ: フォントファイル (.ttf, .woff2)
+
+**適切な用途:** テンプレート、ボイラープレートコード、ドキュメントテンプレート、画像、アイコン、フォント、または最終出力でコピーまたは使用されるファイル。
+
+---
+
+**不要なディレクトリは削除できます。** すべてのSkillが3種類のリソースすべてを必要とするわけではありません。
+
+## einja固有の注意事項
+
+### マネージドセクション
+
+一部のドキュメントでマネージドセクションを使用する場合：
+
+```markdown
+<!-- @einja:managed:start -->
+この内容は`einja sync`で上書きされる
+<!-- @einja:managed:end -->
+
+<!-- @einja:seed:start id="unique-id" -->
+プロジェクト固有の内容をここに追記
+<!-- @einja:seed:end -->
+```
+
+### ビルドシステム連携
+
+einja management templateでは、`.claude/skills/einja-*/` 内のファイルはビルド時に自動的に `presets/default/` にコピーされます。
+
+### 関連Skill
+
+- [einja-output-format](../einja-output-format/SKILL.md) - サブエージェント出力形式
+- [einja-coding-standards](../einja-coding-standards/SKILL.md) - コーディング規約
+"""
+
+EXAMPLE_SCRIPT = '''#!/usr/bin/env python3
+"""
+{skill_name}のための例のヘルパースクリプト
+
+これは直接実行できるプレースホルダースクリプトです。
+実際の実装に置き換えるか、不要な場合は削除してください。
+
+他のSkillからの実際のスクリプト例:
+- pdf/scripts/fill_fillable_fields.py - PDFフォームフィールドに入力
+- pdf/scripts/convert_pdf_to_images.py - PDFページを画像に変換
+"""
+
+def main():
+    print("これは{skill_name}の例のスクリプトです")
+    # TODO: ここに実際のスクリプトロジックを追加
+    # これはデータ処理、ファイル変換、API呼び出し等です。
+
+if __name__ == "__main__":
+    main()
+'''
+
+EXAMPLE_REFERENCE = """# {skill_title}のリファレンスドキュメント
+
+これは詳細なリファレンスドキュメントのプレースホルダーです。
+実際のリファレンスコンテンツに置き換えるか、不要な場合は削除してください。
+
+他のSkillからの実際のリファレンスドキュメント例:
+- product-management/reference/communication.md - ステータス更新のための包括的なガイド
+- product-management/reference/context_building.md - コンテキスト収集の深掘り
+- bigquery/reference/ - APIリファレンスとクエリ例
+
+## リファレンスドキュメントが有用な場合
+
+リファレンスドキュメントは以下に最適:
+- 包括的なAPIドキュメント
+- 詳細なワークフローガイド
+- 複雑な複数ステップのプロセス
+- メインのSKILL.mdには長すぎる情報
+- 特定のユースケースにのみ必要なコンテンツ
+
+## 構造の提案
+
+### APIリファレンスの例
+- 概要
+- 認証
+- 例付きエンドポイント
+- エラーコード
+- レート制限
+
+### ワークフローガイドの例
+- 前提条件
+- ステップバイステップの指示
+- 一般的なパターン
+- トラブルシューティング
+- ベストプラクティス
+"""
+
+EXAMPLE_ASSET = """# 例のアセットファイル
+
+このプレースホルダーは、アセットファイルが保存される場所を表しています。
+実際のアセットファイル（テンプレート、画像、フォント等）に置き換えるか、不要な場合は削除してください。
+
+アセットファイルはコンテキストに読み込まれることを意図せず、Claudeが生成する
+出力で使用されます。
+
+他のSkillからの例のアセットファイル:
+- ブランドガイドライン: logo.png, slides_template.pptx
+- フロントエンドビルダー: HTML/Reactボイラープレートを含むhello-world/ディレクトリ
+- タイポグラフィ: custom-font.ttf, font-family.woff2
+- データ: sample_data.csv, test_dataset.json
+
+## 一般的なアセットタイプ
+
+- テンプレート: .pptx, .docx, ボイラープレートディレクトリ
+- 画像: .png, .jpg, .svg, .gif
+- フォント: .ttf, .otf, .woff, .woff2
+- ボイラープレートコード: プロジェクトディレクトリ、スターターファイル
+- アイコン: .ico, .svg
+- データファイル: .csv, .json, .xml, .yaml
+
+注意: これはテキストプレースホルダーです。実際のアセットは任意のファイルタイプにできます。
+"""
+
+
+def title_case_skill_name(skill_name):
+    """ハイフン区切りのスキル名を表示用のタイトルケースに変換"""
+    return ' '.join(word.capitalize() for word in skill_name.split('-'))
+
+
+def init_skill(skill_name, path):
+    """
+    テンプレートSKILL.mdを含む新しいSkillディレクトリを初期化
+
+    Args:
+        skill_name: Skillの名前
+        path: Skillディレクトリを作成するパス
+
+    Returns:
+        作成されたSkillディレクトリへのパス、エラーの場合はNone
+    """
+    # Skillディレクトリパスを決定
+    skill_dir = Path(path).resolve() / skill_name
+
+    # ディレクトリがすでに存在するか確認
+    if skill_dir.exists():
+        print(f"❌ エラー: Skillディレクトリはすでに存在します: {skill_dir}")
+        return None
+
+    # Skillディレクトリを作成
+    try:
+        skill_dir.mkdir(parents=True, exist_ok=False)
+        print(f"✅ Skillディレクトリを作成しました: {skill_dir}")
+    except Exception as e:
+        print(f"❌ ディレクトリ作成エラー: {e}")
+        return None
+
+    # テンプレートからSKILL.mdを作成
+    skill_title = title_case_skill_name(skill_name)
+    skill_content = SKILL_TEMPLATE.format(
+        skill_name=skill_name,
+        skill_title=skill_title
+    )
+
+    skill_md_path = skill_dir / 'SKILL.md'
+    try:
+        skill_md_path.write_text(skill_content)
+        print("✅ SKILL.mdを作成しました")
+    except Exception as e:
+        print(f"❌ SKILL.md作成エラー: {e}")
+        return None
+
+    # 例のファイルを含むリソースディレクトリを作成
+    try:
+        # 例のスクリプトを含むscripts/ディレクトリを作成
+        scripts_dir = skill_dir / 'scripts'
+        scripts_dir.mkdir(exist_ok=True)
+        example_script = scripts_dir / 'example.py'
+        example_script.write_text(EXAMPLE_SCRIPT.format(skill_name=skill_name))
+        example_script.chmod(0o755)
+        print("✅ scripts/example.pyを作成しました")
+
+        # 例のリファレンスドキュメントを含むreferences/ディレクトリを作成
+        reference_dir = skill_dir / 'references'
+        reference_dir.mkdir(exist_ok=True)
+        example_reference = reference_dir / 'api_reference.md'
+        example_reference.write_text(EXAMPLE_REFERENCE.format(skill_title=skill_title))
+        print("✅ references/api_reference.mdを作成しました")
+
+        # 例のアセットプレースホルダーを含むassets/ディレクトリを作成
+        assets_dir = skill_dir / 'assets'
+        assets_dir.mkdir(exist_ok=True)
+        example_asset = assets_dir / 'example_asset.txt'
+        example_asset.write_text(EXAMPLE_ASSET)
+        print("✅ assets/example_asset.txtを作成しました")
+    except Exception as e:
+        print(f"❌ リソースディレクトリ作成エラー: {e}")
+        return None
+
+    # 次のステップを表示
+    print(f"\n✅ Skill '{skill_name}' を {skill_dir} に初期化しました")
+    print("\n次のステップ:")
+    print("1. SKILL.mdを編集してTODO項目を完了し、descriptionを更新")
+    print("2. scripts/、references/、assets/の例のファイルをカスタマイズまたは削除")
+    print("3. 準備ができたら、バリデータを実行してSkill構造を確認")
+
+    return skill_dir
+
+
+def main():
+    if len(sys.argv) < 4 or sys.argv[2] != '--path':
+        print("使用法: init_skill.py <skill-name> --path <path>")
+        print("\nSkill名の要件:")
+        print("  - ケバブケース識別子（例: 'my-data-analyzer'）")
+        print("  - 小文字、数字、ハイフンのみ")
+        print("  - 最大64文字")
+        print("  - ディレクトリ名と正確に一致する必要があります")
+        print("\neinja固有:")
+        print("  - einjaプロジェクトでは 'einja-' プレフィックスを推奨")
+        print("  - references/ディレクトリは複数形（公式仕様準拠）")
+        print("\n例:")
+        print("  init_skill.py einja-my-new-skill --path .claude/skills")
+        print("  init_skill.py einja-api-helper --path .claude/skills")
+        print("  init_skill.py custom-skill --path /custom/location")
+        sys.exit(1)
+
+    skill_name = sys.argv[1]
+    path = sys.argv[3]
+
+    print(f"🚀 Skillを初期化中: {skill_name}")
+    print(f"   場所: {path}")
+    print()
+
+    result = init_skill(skill_name, path)
+
+    if result:
+        sys.exit(0)
+    else:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/presets/default/.claude/skills/einja-skill-creator/scripts/package_skill.py

@@ -0,0 +1,110 @@
+#!/usr/bin/env python3
+"""
+Skillパッケージャー - Skillフォルダの配布可能な.skillファイルを作成
+
+使用法:
+    python package_skill.py <path/to/skill-folder> [output-directory]
+
+例:
+    python package_skill.py .claude/skills/einja-my-skill
+    python package_skill.py .claude/skills/einja-my-skill ./dist
+"""
+
+import sys
+import zipfile
+from pathlib import Path
+from quick_validate import validate_skill
+
+
+def package_skill(skill_path, output_dir=None):
+    """
+    Skillフォルダを.skillファイルにパッケージ化
+
+    Args:
+        skill_path: Skillフォルダへのパス
+        output_dir: .skillファイルのオプションの出力ディレクトリ（デフォルトは現在のディレクトリ）
+
+    Returns:
+        作成された.skillファイルへのパス、エラーの場合はNone
+    """
+    skill_path = Path(skill_path).resolve()
+
+    # Skillフォルダが存在することを検証
+    if not skill_path.exists():
+        print(f"❌ エラー: Skillフォルダが見つかりません: {skill_path}")
+        return None
+
+    if not skill_path.is_dir():
+        print(f"❌ エラー: パスはディレクトリではありません: {skill_path}")
+        return None
+
+    # SKILL.mdが存在することを検証
+    skill_md = skill_path / "SKILL.md"
+    if not skill_md.exists():
+        print(f"❌ エラー: {skill_path} にSKILL.mdが見つかりません")
+        return None
+
+    # パッケージ化前にバリデーションを実行
+    print("🔍 Skillをバリデーション中...")
+    valid, message = validate_skill(skill_path)
+    if not valid:
+        print(f"❌ バリデーション失敗: {message}")
+        print("   パッケージ化前にバリデーションエラーを修正してください。")
+        return None
+    print(f"✅ {message}\n")
+
+    # 出力場所を決定
+    skill_name = skill_path.name
+    if output_dir:
+        output_path = Path(output_dir).resolve()
+        output_path.mkdir(parents=True, exist_ok=True)
+    else:
+        output_path = Path.cwd()
+
+    skill_filename = output_path / f"{skill_name}.skill"
+
+    # .skillファイル（zip形式）を作成
+    try:
+        with zipfile.ZipFile(skill_filename, 'w', zipfile.ZIP_DEFLATED) as zipf:
+            # Skillディレクトリを走査
+            for file_path in skill_path.rglob('*'):
+                if file_path.is_file():
+                    # zip内の相対パスを計算
+                    arcname = file_path.relative_to(skill_path.parent)
+                    zipf.write(file_path, arcname)
+                    print(f"  追加: {arcname}")
+
+        print(f"\n✅ Skillを正常にパッケージ化しました: {skill_filename}")
+        return skill_filename
+
+    except Exception as e:
+        print(f"❌ .skillファイル作成エラー: {e}")
+        return None
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("使用法: python package_skill.py <path/to/skill-folder> [output-directory]")
+        print("\n例:")
+        print("  python package_skill.py .claude/skills/einja-my-skill")
+        print("  python package_skill.py .claude/skills/einja-my-skill ./dist")
+        sys.exit(1)
+
+    skill_path = sys.argv[1]
+    output_dir = sys.argv[2] if len(sys.argv) > 2 else None
+
+    print(f"📦 Skillをパッケージ化中: {skill_path}")
+    if output_dir:
+        print(f"   出力ディレクトリ: {output_dir}")
+    print()
+
+    result = package_skill(skill_path, output_dir)
+
+    if result:
+        sys.exit(0)
+    else:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/presets/default/.claude/skills/einja-skill-creator/scripts/quick_validate.py

@@ -0,0 +1,117 @@
+#!/usr/bin/env python3
+"""
+Skillの簡易バリデーションスクリプト - 最小バージョン
+"""
+
+import sys
+import os
+import re
+import yaml
+from pathlib import Path
+
+def validate_skill(skill_path):
+    """Skillの基本バリデーション"""
+    skill_path = Path(skill_path)
+
+    # SKILL.mdの存在を確認
+    skill_md = skill_path / 'SKILL.md'
+    if not skill_md.exists():
+        return False, "SKILL.mdが見つかりません"
+
+    # フロントマターの読み込みと検証
+    content = skill_md.read_text()
+    if not content.startswith('---'):
+        return False, "YAMLフロントマターが見つかりません"
+
+    # フロントマターの抽出
+    match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
+    if not match:
+        return False, "無効なフロントマター形式"
+
+    frontmatter_text = match.group(1)
+
+    # YAMLフロントマターのパース
+    try:
+        frontmatter = yaml.safe_load(frontmatter_text)
+        if not isinstance(frontmatter, dict):
+            return False, "フロントマターはYAML辞書である必要があります"
+    except yaml.YAMLError as e:
+        return False, f"フロントマターの無効なYAML: {e}"
+
+    # 許可されたプロパティを定義
+    ALLOWED_PROPERTIES = {'name', 'description', 'license', 'allowed-tools', 'metadata', 'compatibility'}
+
+    # 予期しないプロパティを確認（metadata配下のネストされたキーを除く）
+    unexpected_keys = set(frontmatter.keys()) - ALLOWED_PROPERTIES
+    if unexpected_keys:
+        return False, (
+            f"SKILL.mdフロントマターに予期しないキー: {', '.join(sorted(unexpected_keys))}。"
+            f"許可されたプロパティ: {', '.join(sorted(ALLOWED_PROPERTIES))}"
+        )
+
+    # 必須フィールドの確認
+    if 'name' not in frontmatter:
+        return False, "フロントマターに'name'がありません"
+    if 'description' not in frontmatter:
+        return False, "フロントマターに'description'がありません"
+
+    # バリデーション用にnameを抽出
+    name = frontmatter.get('name', '')
+    if not isinstance(name, str):
+        return False, f"Nameは文字列である必要があります。{type(name).__name__}が指定されました"
+    name = name.strip()
+    if name:
+        # 命名規則をチェック（ケバブケース: 小文字、ハイフンのみ）
+        if not re.match(r'^[a-z0-9-]+$', name):
+            return False, f"Name '{name}' はケバブケース（小文字、数字、ハイフンのみ）である必要があります"
+        if name.startswith('-') or name.endswith('-') or '--' in name:
+            return False, f"Name '{name}' はハイフンで始まる/終わる、または連続したハイフンを含めません"
+        # 名前の長さをチェック（仕様に従い最大64文字）
+        if len(name) > 64:
+            return False, f"Nameが長すぎます（{len(name)}文字）。最大64文字です。"
+
+        # einja固有: einja-プレフィックスの推奨（警告レベル）
+        if not name.startswith('einja-'):
+            print(f"⚠️  警告: einjaプロジェクトでは 'einja-' プレフィックスを推奨します（現在: '{name}'）")
+
+    # descriptionを抽出・検証
+    description = frontmatter.get('description', '')
+    if not isinstance(description, str):
+        return False, f"Descriptionは文字列である必要があります。{type(description).__name__}が指定されました"
+    description = description.strip()
+    if description:
+        # 山括弧を確認
+        if '<' in description or '>' in description:
+            return False, "Descriptionには山括弧（<または>）を含められません"
+        # descriptionの長さをチェック（仕様に従い最大1024文字）
+        if len(description) > 1024:
+            return False, f"Descriptionが長すぎます（{len(description)}文字）。最大1024文字です。"
+
+    # compatibilityフィールドが存在する場合に検証（オプション）
+    compatibility = frontmatter.get('compatibility', '')
+    if compatibility:
+        if not isinstance(compatibility, str):
+            return False, f"Compatibilityは文字列である必要があります。{type(compatibility).__name__}が指定されました"
+        if len(compatibility) > 500:
+            return False, f"Compatibilityが長すぎます（{len(compatibility)}文字）。最大500文字です。"
+
+    # einja固有: SKILL.mdの行数チェック（500行以内推奨）
+    line_count = len(content.split('\n'))
+    if line_count > 500:
+        print(f"⚠️  警告: SKILL.mdが500行を超えています（{line_count}行）。コンテンツをreferenceファイルに分割することを検討してください。")
+
+    # einja固有: references/ディレクトリ名チェック（reference/は警告）
+    reference_dir = skill_path / 'reference'
+    if reference_dir.exists():
+        print(f"⚠️  警告: 'reference/'ディレクトリが見つかりました。公式仕様に準拠し 'references/'（複数形）を使用してください。")
+
+    return True, "Skillは有効です！"
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        print("使用法: python quick_validate.py <skill_directory>")
+        sys.exit(1)
+
+    valid, message = validate_skill(sys.argv[1])
+    print(message)
+    sys.exit(0 if valid else 1)

package/presets/default/.claude/skills/einja-spec-context-loader/SKILL.md

@@ -21,9 +21,9 @@ spec-create で作成された仕様書（requirements.md、design.md、qa-tests
 
 **必須パラメータ**:
 - `spec_dir`: spec ディレクトリのパス（例: `/docs/specs/issues/auth/issue21-login-feature/`）
-- `task_group_id`: タスクグループID（例: `1.1`）
+- `ac_ids`: 対象AC番号（例: `AC1.1, AC1.2`）
 
-**入力形式**: `{spec_dir} --task-group-id {task_group_id}`
+**入力形式**: 自然言語でAC情報を指定
 
 ---
 
@@ -67,8 +67,8 @@ spec-create で作成された仕様書（requirements.md、design.md、qa-tests
 
 ### ステップ4: qa-tests/ からのテスト仕様抽出
 
-1. タスクグループIDからテストファイルを特定
-   - 例: `1.1` → `qa-tests/phase1/1-1.md`
+1. AC番号からストーリー番号を特定し、テストファイルを参照
+   - 例: AC1.1 → Story 1 → `qa-tests/story1.md`、AC2.3 → Story 2 → `qa-tests/story2.md`
 2. scenarios.md から該当タスクのシナリオテストを確認
 3. 以下の情報を抽出:
    - **テストシナリオ**: 実行すべきテストケース
@@ -86,7 +86,7 @@ spec-create で作成された仕様書（requirements.md、design.md、qa-tests
 
 ### spec 情報
 - **ディレクトリ**: {spec_dir}
-- **タスクグループ**: {task_group_id}
+- **対象AC**: {ac_ids}
 
 ### 要件
 #### 機能要件
@@ -126,7 +126,7 @@ interface Example {
 
 ### テスト仕様
 #### 対象テストファイル
-- `qa-tests/phase{N}/{X}-{Y}.md`
+- `qa-tests/story{N}.md`（該当ACセクション）
 
 #### シナリオテスト
 - **シナリオ1**: [概要] - 実施タイミング: [Step X-Y]