MIT ライセンスのローカルファーストなエージェント観測プラグイン(DeepSeek Harness 対応、Claude Code でも動作)。セッション時間を計測し、脇道にそれたら鞭を入れ、振り返りを指示とスキルへ書き戻します。データはローカル JSONL のみで、アップロードも採点もしません。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-20
ライセンス
MIT
01どんなタスクに使えるのか?
エージェントのセッションで時間が実際どこに消えたのかを突き止める
ローカルのタイムライン:ツールごとの名前と成否、ラウンドごとの `stop`、あなたが次を打つときの `prompt` と `user_wait` / `idle_gap`、手戻りシグナル。セッションの Crop タブと横断ビューで確認できます
長いセッションを回していて、遅いのがエージェントか自分の思考時間か分からない開発者
セッションごとに、指示・スキル・ツールへの検証可能な小さな修正に変える
`crop_update` による自己申告(フェーズ、タスク、`cause` / `category`、次の一手)と作業サマリ。何をなぜ変え、効いたのかは `crop ledger` がイベントログで示します
ハーネスエンジニアリングとして、エージェント改善を計測可能なループとして扱いたい人
記録側そのものが黙っていないかを確かめる
`crop health --days 7`(人が読む要約)または `crop health --json`(完全な `health_summary`)。`days` / `host` を取る `crop_health` ツールからも同じ情報が得られます
数字を疑いたい人。README も「データが信用できないと思ったら直接呼べ」と書いています
02DeepSeek Harness への導入方法
インストール手順
- 01
プラグインを入れる:`dsh plugin --profile <あなたの profile> add agent-crop-dsh`
$ dsh plugin --profile <あなたの profile> add agent-crop-dsh
- 02
$ dsh を再起動すると、新しいセッションから有効になります
- 03
任意:`npm i -g agent-crop-dsh` で `crop` コマンドを `PATH` に通すか、`npx --yes --package=agent-crop-dsh -- crop status` で都度実行します
$ npm i -g agent-crop-dsh
- 04
ソースを触る場合は clone して link:`git clone https://github.com/oriliz/agent-crop.git ~/agent-crop` のあと `dsh plugin --profile <あなたの profile> add ~/agent-crop`
$ git clone https://github.com/oriliz/agent-crop.git ~/agent-crop
導入成功の確認
- `crop status` が動き、最後の行に実際のデータディレクトリが出る
- `tail -1 ~/.agentcrop/data/events.jsonl` に `"host":"dsh"` を含むイベントがある
- `crop health --days 7`(またはセッション内の `crop_health` ツール)が健全性サマリを返す
ロールバック
- プラグインを外す:`dsh plugin --profile <あなたの profile> remove agent-crop-dsh`
- アンインストールしてもデータは残ります。一緒に消すなら `rm -rf ~/.agentcrop` を実行します
03DSH 統合と能力の範囲
`agent-crop-dsh` という DSH プラグインとして導入し、記録プロトコルをシステムプロンプトに登録したうえで、`crop_update` / `crop_health` と Crop パネルを提供します
パッシブなタイムライン記録
セッションでの各ツールの戻り、ラウンド終了、あなたの次の発話→`tool` イベント(名前と成否)、`stop`(そのラウンドの稼働分)、`prompt`(`user_wait` / `idle_gap`)
1 ラウンドにつき 100〜300 文字の注入`~/.agentcrop/data` への JSONL 追記(権限 0700)鞭と AI の自己申告
長く応答が止まった、または黄線 / 赤線を越えたセッション→鞭のプロンプトに続いて、`phase` / `cause` / `category` / 次の一手を含む `crop_update` の申告
`category` は 9 値の固定列挙で、誤った値は失敗します詰まったときの自己申告は約 50〜100 トークン2 つのパネル
1 つのセッション、または複数セッションのイベント記録→セッションの Crop タブ:セッションクロック(稼働 / 待ち)、作業ごとの lane、鞭のステッカーと回数、振り返りと改善。グローバルの Crop:5 つの摩擦指標、日次の稼働 / 待ち積み上げ、改善、まだ残る落とし穴、作業一覧
記録側の健全性チェック
`crop health --days 7`、`crop health --json`、または `days` / `host` を取る `crop_health` ツール→有効セッション、締め率、必須取得の達成度、異常ツール、イベント種別ごとのカバレッジ、診断リスト
計測された自己改善ループ
過去セッションのイベント→計測 → 原因特定 → 指示 / スキル / ツールの変更 → 再計測。各振り返りは検証可能な 1 つの修正として `crop ledger` に残ります
04誰に向いているのか?使うべきでない場面は?
向いている用途
- 長いセッションを回していて、遅いのがエージェントか自分の思考時間か分からない開発者
- ハーネスエンジニアリングとして、エージェント改善を計測可能なループとして扱いたい人
- 数字を疑いたい人。README も「データが信用できないと思ったら直接呼べ」と書いています
不向きな用途
- 作者自身が開発中と述べており、README も弱点を挙げています。データのカバレッジは低め(`type` / `difficulty` は頻繁に空で、前期比較は「データなし」になることが多い)、健全性のしきい値(カバレッジ ≥ 80%、フィールド充足 ≥ 95%)は暫定値で実データ未校正、セッションが 3 件未満なら「サンプル不足」としか出しません。
- AI が書く項目は判断であって事実ではありません。README は自己申告だけを結論にせず、自動収集した時間や失敗数と突き合わせるよう明記しています。
05互換性・メンテナンス・セキュリティ上の注意
- 作者自身が開発中と述べており、README も弱点を挙げています。データのカバレッジは低め(`type` / `difficulty` は頻繁に空で、前期比較は「データなし」になることが多い)、健全性のしきい値(カバレッジ ≥ 80%、フィールド充足 ≥ 95%)は暫定値で実データ未校正、セッションが 3 件未満なら「サンプル不足」としか出しません。
- AI が書く項目は判断であって事実ではありません。README は自己申告だけを結論にせず、自動収集した時間や失敗数と突き合わせるよう明記しています。
- 小さいながらコストはあります。1 ラウンドあたり 100〜300 文字の注入、詰まったときの申告で約 50〜100 トークン。20 ラウンドの作業で合計約 2k トークンと README は見積もっています。
- このページが扱うのは DeepSeek Harness のプラグイン経路のみです。README は Claude Code の導入を `docs/INSTALL.md` に委ねており、そちらは MCP 経由(`crop_health` が `crop_update` と並んで公開)です。健全性ビューはホストのドロップダウンで dsh / claude-code を切り分け、`crop_health` ツールも `host` 引数を受け取ります。
MIT · 活発にメンテナンス中(最新リリース v0.8.4、2026-11-18)
06よくある質問
DSH への入れ方は?
`dsh plugin --profile <あなたの profile> add agent-crop-dsh` を実行し、dsh を再起動します。新しいセッションから有効になります。npm から入るのはビルド済みの成果物なので、手元でビルドスクリプトは走らず、pnpm の `allowBuilds` を許可する必要もありません。
AGENTS.md や設定の編集は必要ですか?
不要です。README によればプロトコルはプラグイン経由でシステムプロンプトに登録され、アンインストール時に自動で外れます。設定する項目も `AGENTS.md` に足す内容もありません。
実際に記録されているか確認するには?
`crop status` を実行すると最後の行に実際のデータディレクトリが出ます。続けて `tail -1 ~/.agentcrop/data/events.jsonl` を見て、`"host":"dsh"` が含まれていれば記録できています。`crop` コマンドは npm パッケージに同梱されますが `dsh plugin add` は `PATH` に通さないので、`npm i -g agent-crop-dsh` か `npx --yes --package=agent-crop-dsh -- crop status` を使います。
データはどこに保存されますか?
このマシンの中だけです。`~/.agentcrop/data`(権限 0700、`KIT_DATA_DIR` で変更可)に置かれ、会話本文は保存しません。旧データディレクトリ名は `~/.ai-coding-efficiency` で、`~/.agentcrop` がまだ無い環境では `crop status` の最後の行に出る実パスが正となります。
叱り方の強さは変えられますか?
変えられます。サイドバーの「プラグイン」ページで Agent Crop の行を開き「設定」から「鞭策風格」を切り替えると、保存だけで再起動なしに反映されます。実際に鞭を入れるのは既定の「奴隷主」だけで、穏やかな先輩・経験豊富な同僚・放任主義の親の 3 つはリマインダーです。文言を差し替えたい場合は `~/.agentcrop/templates/voice/*.md` に Markdown を置きますが、この上書きは既定スタイルにのみ効きます。
07関連する DSH ワークフロー
dsh-our-free-model
by ebony-vinyl
ログインやAPIキーなしでDeepSeek V4.1 FlashやKimi K3などを利用できるとし、無料・無制限をうたうDeepSeek Harness向けプラグインです。
dsh-routing-suite
by yjh051108
DeepSeek Harness(dsh)向けのルーティング套件。まずランタイムインジェクターを導入し、続いてタスク認識型の推論モードルーター(P1〜P23 を計測済み)を組み込めます。
dsh-ops
by t-auto
Bash と PowerShell コマンドを実行し、ローカルファイルを検索および編集し、DSH から長期にわたるバックグラウンドジョブを管理します.
dsh-connect-workbuddy
by dingminhua
ローカルにサインインしたWorkBuddyモデルをDeepSeek Harnessへ接続。読み取り専用のクレジット概要とモデル管理を提供。
08データと出典
dsh plugin --profile <你的 profile> add agent-crop-dsh
被抽完,AI 要**反思与上报**——调 `crop_update` 写下 `cause` / `verdict` / `category`,这是整条链上唯一由 AI 主动补的动作。
DSH 插件:工具 `crop_health`(参数 `days` / `host`),怀疑数据不可信时直接调。
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-20。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
