AI成果物受け入れツール v0.1

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で差分確認できる環境を推奨

無料版について

無料版やサンプル版は今後検討予定です。

初回は、有料版の運用パッケージとして公開し、実際の使いやすさを確認しながら改善していきます。