~/hayashigoto

> ~/hayashigoto/works/hikizan/

README.md

hikizan — 幅広い実務に共通するAIエージェントワークフローの要点

AIエージェントへ細かな工程を強制せず、調査と実装、提出の境界を明示的な依頼へ結びつける日本語スキルパック。六つのスキルと任意のHookを、複数の実行環境へ配布している。

project.yml
year:
2026
role:
System Design / Software Development
category:
探索
stack:
Agent PluginsAgent SkillsBashMarkdown
links.yml
details.md

hikizanは、AIエージェントへ仕事を頼むときの認知負荷を減らす、日本語のAgent Skillsスキルパックです。調べる、決める、作る、見る、出す、伝えるという六つの動詞へ責務を分け、Agent Plugins v1に対応した形式で配布しています。

v1で固定した境界

v1では、六つのスキルIDと、それぞれを独立した観点として扱う構成を互換性の基準にしました。六つのスキルは順番に通すワークフローではなく、依頼そのものから必要な役割だけを選びます。

調査、相談、設計、レビューだけの依頼では対象を変更せず、修正や実行が明示された場合だけ実装を始めます。PRのマージと既定ブランチへの直接のpushも、依頼の終点として明示された場合だけ行います。

検証量は変更の大きさではなくリスクで決めます。局所的で戻しやすい変更は最寄りの検査、APIやロジックの変更は回帰検査、権限やデータに関わる変更は対象レビューと全体検証まで広げます。

スキルと起動情報を分ける

ハーネスに依存しないskills/と、任意で追加できるHookを分けています。Claude Codeでは専用プラグイン、CodexとCursorではAgent PluginsとHookアダプター、そのほかの対応環境ではAgent Pluginsを使い、スキルだけ必要な環境にはAgent Skillsとして配布します。

Hookは、依頼に合うスキルの案内と、開始時のリポジトリ状態だけを渡します。スキル側には判断の基準と作業手順を置き、Hookを使わない環境でも六つの役割が独立して動く構成です。

広域調査や専門レビューは、利用中の環境に標準サブエージェントがある場合だけ委譲します。使えない場合は親エージェントが同じ範囲を確認します。

現在の位置づけ

当初は弱いモデルでも工程を外さないための細かなレールを多く持っていました。モデルの自律性が上がった現在は、作業方法を拘束する記述を減らし、勝手に作業を始めないこと、次の判断を分かりやすく返すこと、Git操作を安全に扱うことなど、人間側のUXと好みを整える用途へ寄せています。

完全な制御を目指すのではなく、本当に守ってほしい境界だけを短く残す。その引き算自体が、このプロジェクトで検証していることです。