archive について
完了した作業計画をアーカイブするエージェントスキルです。成果と学びを記録し、計画の名前を変更してコミットします。ai-workspace/plans/ に計画を置くリポジトリのワークフローを対象とします。
主な機能
- 01最新の未完了計画を検索
- 02成果と学びを記録
- 03計画を完了済みに変更
- 04アーカイブした計画をコミット
活用シーン
- 01完了した実装計画のアーカイブ
- 02作業後の学びの記録
- 03リポジトリ内の計画履歴の管理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ camacho/ ai-skills --skill archiveインストール後、Claude Code で/archiveを入力して読み込まれたか確認します。
詳細
入力
WORKTREE:現在のワークツリーの絶対パス(セッションの CWD またはgit rev-parse --show-toplevelから解決します)- プランファイルのパス(デフォルト:
$WORKTREE/ai-workspace/plans/内で最新の.done.mdではないファイル)
手順
-
プランファイルを見つけます:
ls -t "$WORKTREE/ai-workspace/plans/"*.md | grep -v '.done.md' | head -1すでに
.done.mdになっている場合 → エラー:「すでにアーカイブされています。」 -
プランファイルを読み込み、計画内容を把握します。
-
成果を収集します:ユーザーに尋ねるか、git log とブランチの状況から推測します。
- うまくいったことは何ですか?
- 計画どおりに進まなかったことは何ですか?
- 何を変えて対応しますか?
ユーザーが回答を省略した場合 → 「成果:未記録」と記載します(処理を中断しません)。
-
「成果と学び」セクションをプランファイルに追加します:
## Outcomes & Learnings **Completed**: [date] ### What Worked - [bullet points] ### What Didn't - [bullet points] ### Learnings - [bullet points] -
.done.mdに名前を変更します:git -C "$WORKTREE" mv ai-workspace/plans/<name>.md ai-workspace/plans/<name>.done.md -
アーカイブをコミットします:
git -C "$WORKTREE" add ai-workspace/plans/<name>.done.md git -C "$WORKTREE" commit -m "docs: archive plan <name> Co-Authored-By: Claude <model>"
出力:プランがアーカイブされたことと、.done.md ファイルへのパスを確認します。
コメント
Markdown 対応