時間はお金｜AI's time is money
ローカルExcelワークブックを使用して、Agentが完了した作業の価値台帳を維持します。Agentが発見、重複排除、見積もり、更新を行い、ユーザーは異常項目のレビューのみを行います。手動で1行ずつ記入する必要はありません。
設計上の境界
- ローカルExcelのみに依存。Feishu、Base、データベース、外部同期サービスには依存しません。
- 台帳は「監査可能な時間代替価値」を記録し、見積もり金額を現金収入、利益、確定収益として表現しません。
- デフォルトでは、保守的な低値
saved_minutes_lowとsaved_cny_lowを外部に表示します。中値と高値はExcelの参考区間のみに配置します。 - 明確な完了状態または成果物がある作業のみを記録します。要件議論、好みの記録、失敗した試行、繰り返しのメンテナンス、提案のみで成果物がない会話はデフォルトでスキップします。
- 完全なチャット、機密原文、資格情報、非公開の財務詳細、不要な個人データは保存しません。証拠は短いタイトル、日付、ソースID、ローカルパス、成果物タイプのみを保存します。
ワークブック構成
優先的にスキル付属の assets/agent-value-ledger-template.xlsx を使用します。ユーザーが既存のワークブックを持っている場合は、まずそれを読み込み、その構造を維持します。必要なワークシートがない場合のみ追加します。
汇总(集計)：低値の主結論、週/月の集計、参考区間、低信頼度、レビュー待ちの数。すべて数式で駆動されます。任务明细(タスク明細)：1行1タスク。時間、価値、信頼度、証拠、仮定を列に分けて保存。规则(ルール)：時給、デフォルトコスト、分類、信頼度、見積もり境界。ルール変更後は更新時刻を保持する必要があります。运行状态(実行状態)：最後のスキャン時刻、スキャンウィンドウ、処理済みソース数、最後のエラー、レビュー待ちの説明。再スキャンをサポートし、追加のstateファイルに依存しません。运行日志(実行ログ)：短いイベント、結果、エラー概要のみを記録し、完全な原文は書き込みません。
必須フィールドと数式については references/workbook-schema.md を参照してください。見積もり基準は references/estimation-policy.md、匿名化と証拠の境界は references/redaction-and-evidence.md を参照してください。
標準フロー
1. ワークブックとルールの読み込み
- ユーザーが指定した
.xlsxファイルを見つけます。指定がない場合は、カレントワーキングディレクトリまたは設定ディレクトリからagent-value-ledger.xlsxを探します。 - まず
规则、运行状态、任务明细、汇总を読み込み、数式、フィールド、最後の実行状態を確認します。 - ワークブックが存在しない場合は、テンプレートをユーザーが明示したローカルパスにコピーします。個人ディレクトリに密かに書き込まないでください。
- 現在の日付、タイムゾーン、時給、報告ポリシーを読み取ります。スキル内のサンプル時給をユーザーの実際の時給として使用しないでください。
2. スキャンと再スキャン
- 利用可能なローカルセッションサマリー、タスク記録、プロジェクトログ、成果物ディレクトリ、バージョン記録をスキャンします。
- デフォルトでは過去7暦日を再スキャンし、「サマリーがセッション完了時刻より後に書き込まれる」ケースに対応します。毎回
任务ID、ソースID、成果物フィンガープリントで重複排除します。 - まず候補リストを作成し、その後完了状態を判断します。スキャン中に直接Excelに書き込まないでください。
- 各候補に
accepted、skipped、needs_reviewのいずれかをマークし、理由を1つ保持します。
3. タスクレコードの作成
各タスクには少なくとも以下を書き込みます：タスクID、作業日、タスクタイトル、短い概要、分類、ソース、成果物、信頼度、3段階の手動時間、3段階のユーザー投入時間、3段階のレビュー手戻り時間、時給、配賦コスト、仮定、証拠ステータス、重複排除キー。
計算ルール：
saved_minutes = max(0, manual_minutes - user_active_minutes - review_minutes)
saved_cny = saved_minutes / 60 * hourly_rate_cny - allocated_cost_cny
Excelでは数式を保持し、計算結果をハードコードしません。サブスクリプション/APIコストを配賦できない場合、コストは0と入力し、仮定に「サブスクリプション/APIコストは未配賦」と明記します。
4. 書き込み前チェック
- タスクID、重複排除キー、成果物フィンガープリントが既に存在する場合：証拠を更新するかスキップし、新しい価値を追加しません。
- 完了証拠がない場合：
needs_reviewに入れ、主集計には含めません。 saved_minutesが0未満の場合：0として処理し、異常を記録します。- 低値が中値より高い、または中値が高値より高い場合：書き込みを停止し、見積もりを修正します。
- 手動で入力された「コード行数、ファイル数、実行時間」は証拠としてのみ使用でき、節約時間に直接換算することはできません。
5. 更新と検証
- まず
任务明细に書き込み、その後汇总の数式を再計算させます。 运行状态と运行日志を記録します。これにはスキャンウィンドウ、候補数、新規追加数、スキップ数、レビュー待ち数、エラー概要が含まれます。- 新しく追加された行、集計キーセル、数式エラースキャン結果を読み戻します。
- ファイルが読み取れない、数式エラー、ソースにアクセスできない、書き込みに失敗した場合は、推測を停止します。
运行日志に失敗と未検証範囲をマークします。 - ユーザーには、低値の主結論、実際の新規タスク数、レビュー待ち項目、ブロッカーのみを報告します。生のJSONや長いログは出力しません。
タスク分類
规则 ワークシートの分類テーブルを使用します。デフォルトの分類は以下の通り：
simple_lookup_or_command：簡単なクエリ、説明、1つのコマンドfeishu_lookup_or_schedule：メッセージ、スケジュール、タスク、ワークスペースクエリdoc_wiki_minutes_synthesis：ドキュメント、Wiki、議事録、翻訳、構造整理report_or_research：調査、分析、提案、判断フレームワークautomation_or_workflow_setup：自動化、データパイプライン、バッチ処理、デプロイ、フロー構築coding_or_debugging：コード修正、トラブルシューティング、テスト、リリース、修正local_setup_or_cleanup：ローカルインストール、クリーンアップ、移行、メンテナンス
セキュリティと公開の境界
- 公開リポジトリへのアップロードは匿名化後に行う必要があります：名前、メールアドレス、電話番号、パス内のユーザー名、トークン、ベースURL、内部ドメイン名、会社クライアント名、非公開ドキュメントタイトルを削除します。
- サンプルワークブックは架空のタスクとサンプル数値のみを使用します。ユーザーの実際の台帳から履歴をコピーしないでください。
- GitHub公開前には、機密情報スキャン、Excel数式エラースキャン、スキル構造検証、公開内容レビューを実行します。
- GitHub公開は本スキルの自動的な副作用ではありません。ユーザーが明示的に公開を要求し、レビューを完了した場合のみ実行します。
リソース
- references/workbook-schema.md：ワークブックのフィールド、数式、ステータス値
- references/estimation-policy.md：3段階見積もり、価値キャリブレーション、不正防止の境界
- references/redaction-and-evidence.md：匿名化、証拠の最小化、公開リリースチェック
- scripts/build_template.mjs：匿名化されたExcelテンプレートを生成または再構築