ディレクトリに戻る

agent-crop

キュレーションリスト掲載メンテナンス: 活発

oriliz/agent-crop

AI コーディングの作業時間を計測し、長引くターンに注意を促し、ローカルの作業台帳と収集状態のダッシュボードを残す。時間がどこへ消えたかが見える。

GitHub で見る
$ dsh plugin --profile <あなたの profile> add agent-crop-dsh

171

スター

0

フォーク

Python

言語

MIT

ライセンス

2026-11-14

作成日

2026-11-20

最終プッシュ

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 への導入方法

インストール手順

  1. 01

    プラグインを入れる:`dsh plugin --profile <あなたの profile> add agent-crop-dsh`

    $ dsh plugin --profile <あなたの profile> add agent-crop-dsh

  2. 02

    $ dsh を再起動すると、新しいセッションから有効になります

  3. 03

    任意:`npm i -g agent-crop-dsh` で `crop` コマンドを `PATH` に通すか、`npx --yes --package=agent-crop-dsh -- crop status` で都度実行します

    $ npm i -g agent-crop-dsh

  4. 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 統合と能力の範囲

DSH 統合ネイティブ実行

`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` 引数を受け取ります。
2026-11-142026-11-17v0.8.4

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 を置きますが、この上書きは既定スタイルにのみ効きます。

08データと出典

  • 作者による申告github.com57330c355cfc…

    dsh plugin --profile <你的 profile> add agent-crop-dsh

  • 作者による申告github.com57330c355cfc…

    被抽完,AI 要**反思与上报**——调 `crop_update` 写下 `cause` / `verdict` / `category`,这是整条链上唯一由 AI 主动补的动作。

  • 作者による申告github.com57330c355cfc…

    DSH 插件:工具 `crop_health`(参数 `days` / `host`),怀疑数据不可信时直接调。

このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-20。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。