taika-izumi

worklog-skillify

"worklog-extract で採用された候補から、writing-skills 委譲で新規スキル作成または既存スキル拡張を行う。スコープ(汎用/プロジェクト固有/固有ルール)で成果物の配置先を振り分け、汎用パスをガイドライン配信元リポジトリ以外で実行しようとした場合は警告する。ユーザーまたは worklog-extract から起動。"

taika-izumi 0 Updated 2d ago

Resources

1
GitHub

Install

npx skillscat add taika-izumi/ai-driven-dev-principles/worklog-skillify

Install via the SkillsCat registry.

SKILL.md

worklog-skillify

worklog-extract で採用された候補(Issue 草案+根拠エントリ参照+確定 scope)から、writing-skills へ委譲して新規スキル作成または既存スキル拡張を行う。薄いオーケストレーション層に留める。

いつ使うか

  • worklog-extract の採用候補を受けて起動(主用途)
  • ユーザーが手動で起動(採用済み Issue から個別にスキル化する場合)

実行環境ガード

スキル冒頭で実行環境がガイドライン配信元リポジトリ(ai-driven-dev-principles)かを判定する:

  • 判定マーカー: git remote -v の URL に ai-driven-dev-principles を含む、または .claude-plugin/plugin.jsonnameai-driven-dev-principles
  • 汎用(プラグイン配信)パス かつ 配信元リポジトリでない場合のみガード発火
  • 固有パス(プロジェクトローカルスキル / AGENTS.md 追記)はガード不要でそのまま進む

ガード発火時の対応(ユーザー確認):

  1. この場のプロジェクトローカルスキル(利用ツールのスキル配置先。Claude Code は .claude/skills/、Codex は .agents/skills/ など)として作成する
  2. 配信元 repo(ai-driven-dev-principles)へ移動して実行する
  3. 中止する

スコープ3分岐(振り分け)

worklog-extract が確定した scope に応じて成果物の配置先を決める:

scope 配置先
汎用(複数プロジェクトで再現・ドメイン非依存) 配信元リポジトリのプラグイン配信スキル skills/<name>/
プロジェクト固有だが価値あり そのプロジェクトのローカルスキル(利用ツールのスキル配置先。Claude Code は .claude/skills/<name>/、Codex は .agents/skills/<name>/ など)
固有ルールでスキル化不要 そのプロジェクトの AGENTS.md に追記(AGENTS.md が無いプロジェクトでは CLAUDE.md に追記する)

手順

  1. 実行環境ガード判定 → 必要なら警告+ユーザー確認(上記 3 分岐)
  2. スコープで振り分け先決定(上表)
  3. 出所点検(汎用スコープ、および配信元リポジトリ(ai-driven-dev-principles)で実行し AGENTS.md 追記へ振り分ける場合。配信元の AGENTS.md は template 経由で配布されるため): 根拠エントリの出所プロジェクト数・モデル世代を数える。単一プロジェクトまたは単一モデル世代に偏る場合、CONTRIBUTING.md「全シナリオ共通: 過剰適合の点検」の是正パターン(適用例への降格 / 発動条件ゲート / 根拠と世代+規範の廃止条件 / 見送り・スコープ降格)の適用をユーザーへ提示する(ADR-0079)
  4. writing-skills へ委譲してスキルを作成/拡張する。references/skill-authoring-techniques.md を併用し、description 最適化と定量 eval ループを回す(Skill Creator は実行時ロードしない。設計時に借用する。ADR-0046)
  5. 汎用パスは既存フローへ橋渡し: 「Issue → extend-guidelines → スキル作成」の配信元リポジトリの既存フローに合流させる
  6. 台帳追記: 作成/拡張完了後、processed.jsonl へ確定結果を追記する
    • skillified(新規スキル作成)または merged(既存スキルへ統合)を追記
    • 対応する adopted エントリの状態を確定させる(追記専用 JSONL のため後続レコードで遷移を表現)
    • 読み側(worklog-extract)は同一 id の最新レコードの outcome を採用する

対応する原則

  • 原則2(関心の分離): 本スキルは薄いオーケストレーション層。実際のスキル authoring は writing-skills へ委譲する
  • 原則4(人間の関与): 実行環境ガード発火時・出所点検の是正提示・汎用パス橋渡しの節目で人間が確認する

関連 ADR

  • ADR-0044: スコープ3分岐・skill3 橋渡し
  • ADR-0045: 台帳ライフサイクル・adopted 状態と遷移
  • ADR-0046: writing-skills 既定・Skill Creator 設計時借用・実行環境ガード
  • ADR-0079: 出所点検