AI成果物受け入れツール v0.1
- ダウンロード商品¥ 480
ChatGPTなどのAIで作ったMarkdown、ソースコード、画像、ZIP、設定ファイルなどを、毎回手作業でコピーしていませんか。 `artifact_intake_tool` は、AIが作った複数ファイルを、いきなり上書きせず、metadata・config・dry-runを使ってローカルプロジェクトへ受け入れるための小さなPython CLIツールです。 本商品は、ツール本体だけでなく、サンプルconfig、metadataテンプレート、sidecar metadataの例、AIにmetadata付き出力を頼むためのプロンプトを含む、「AI成果物受け入れ運用パッケージ」として使うことを想定しています。
こんな人向け
- ChatGPTなどでMarkdown、ソースコード、画像、ZIP、設定ファイルなどをよく作る - AI出力を毎回コピペしてファイルに反映している - 画像や資料ファイルを、あとでどこに置くか迷うことがある - 既存ファイルの上書きが少し怖い - 複数ファイルの配置先を毎回考えるのが面倒 - Git diffやpytestで確認しながら安全に取り込みたい - エージェントに全部任せるほどではないが、手作業も減らしたい
この商品でできること
- AI成果物を一時フォルダから読み取る - Markdown frontmatter / ソースコードコメント / sidecar metadata を読む - 画像・ZIP・JSONなど、本文にmetadataを入れにくいファイルは sidecar metadata で扱う - dry-runで配置予定を確認する - copy / overwrite / move で取り込む - 上書きには二重確認を使う - move後の空フォルダを整理する - 対象外ファイルが残る場合はINFO表示する
重要: ツールだけで完結する商品ではありません
このツールを便利に使うには、AIが作る成果物側に「どこへ置くか」の情報が必要です。 そのため、本商品では以下をセットにしています。 - サンプルconfig - metadataテンプレート - sidecar metadataテンプレート - AIにmetadata付きで出力してもらうプロンプト - dry-run → apply → Git diff の短い運用手順 最初はサンプルconfigで動かし、慣れてきたら自分のプロジェクト用にtarget_keyやmetadataを調整する流れを想定しています。
使い方イメージ
1. ZIPを展開したフォルダへ移動します。 cd <ZIPを展開したフォルダ>\artifact_intake_tool_v0_1_paid 2. dry-runで配置予定を確認します。 python src\artifact_intake.py dry-run --config configs\sample\config_demo_dry_run.json --show-skipped 3. 問題なければ取り込みます。 python src\artifact_intake.py apply --config configs\sample\config_demo_apply_copy.json --yes --allow-overwrite 4. Gitで確認します。 git status git diff pytest
実行ログのイメージ
[DRY-RUN - not applied] READY : 5 SKIPPED: 0 ERROR : 0 [APPLIED] APPLIED: 5 SKIPPED: 0 ERROR : 0 dry-runでは、copy / move / delete / git commit は行いません。 applyでも、ツール側でGit commitやpushは行いません。最後の確認は人間が行う前提です。
安全設計
- project_root外には配置しません - Git commit / push はしません - 上書きには config と --allow-overwrite の両方が必要です - external_readonly ではmoveしません - 対象外ファイルは自動削除しません - まずdry-runで確認できます
通常のコピーで十分な場合
フォルダを丸ごと1か所に置くだけなら、通常のコピーで十分です。 `artifact_intake_tool` は、複数のAI成果物をmetadataやconfigに従って別々の場所へ安全に振り分けたいときに使います。
含まれるもの
- Python CLI本体 - サンプルconfig - metadataテンプレート - sidecar metadataテンプレート - AIにmetadata付き出力を頼むプロンプト - 短い使い方ガイド - 安全上の注意 - サンプルファイル - LICENSE_NOTICE
注意事項
このツールは「AIが作ったファイルを自動で完全に判断するツール」ではありません。 metadataやconfigに基づいて配置先を決めます。 AIが作ったmetadataやconfigは、必ずdry-runで確認してください。 また、PythonやPowerShellの基本操作、ローカルファイル操作、Git差分確認にある程度慣れている方向けです。
動作環境
- Windows環境を主に想定 - Python 3.x - PowerShell - Gitで差分確認できる環境を推奨
無料版について
無料版やサンプル版は今後検討予定です。 初回は、有料版の運用パッケージとして公開し、実際の使いやすさを確認しながら改善していきます。