ワークフロー結晶化 → .workflow.md

反復的なワークフローを chainskills フレームワーク用の .workflow.md ファイルに結晶化します。

ステップ

1. セッション分析 : 繰り返されるアクション(使用ツール、修正ファイル、パターン)を特定します
2. 不変要素の抽出 : 各実行で同じもの(構造、検証、パターン)を抽出します
3. 変数の抽出 : 変更されるもの(名前、パス、設定) → inputs: になります
4. 結晶化 : 下記フォーマットで .workflow.md を作成します

必須 .workflow.md フォーマット

---
name: <kebab-case>
description: <ワークフローの説明>
version: 0.1.0
inputs:
  - name: <param>
    type: string|number|boolean|list
    required: true|false
    description: <説明>
outputs:
  - name: <result>
    type: string|object
    description: <説明>
tags: [datalake, <category>]
metadata:
  author: TheWatcher01
  project: datalake-souverain
---

# Step N — タイトル

自然言語での説明。

@call shell.exec("commande $variable") -> $resultat
@agent copilot: "Prompt avec $context" -> $output
@assert $condition "message erreur"
@parallel:
## Branche A
@call ...
## Branche B
@call ...

利用可能なディレクティブ

ディレクティブ	用途
@call shell.exec("cmd") -> $var	シェルコマンド
@agent copilot: "prompt" -> $var	LLM へ委譲
@if $var == "val":	条件分岐
@for $item in $list:	ループ
@parallel:	並列実行(DAG)
@try: ... @on-error: log and continue	エラー処理
@assert $var != "" "msg"	検証
@output $var -> $result	出力を宣言
@workflow sub-workflow:	サブワークフローの構成

結晶化ルール

1. 生成より適用 : 既存ワークフロー内のテンプレートを常に参照してください
2. 創造性より決定性 : シェルステップは決定的です。@agent は創造的なタスクのみで使用します
3. 並列化 : 独立したステップ(テンプレート読み込み + 設定読み込みなど)に @parallel: を使用します
4. 出所 : すべてのワークフロー データに lineage_run_id を含めます
5. テスト可能 : 各ワークフローは --dry-run で実行可能である必要があります

保存場所

保存先: ~/projects/chainskills/cli-mcp-core/templates/datalake/<name>.workflow.md

既存ワークフロー(重複させない)

• add-crawler — 新規クローラー(AsyncGenerator + TokenBucket + CircuitBreaker)
• add-api-route — 新規 Hono ルート
• add-data-import — データセット インポート(CSV/JSON/API)
• fix-type-errors — TypeScript エラー修正
• cross-ref-source — ソース間クロスリファレンス
• verify-data — ISO 8000-8 検証(templates/data/ 内)