ECdison6227/project-guardian-cheap-code-delegate

Project Guardian

在專案邊界使用此技能：

• 啟動專案時。
• 上下文遺失或開啟新執行緒後恢復時。
• 進行重大編輯之前。
• 檔案修改之後。
• 低成本工作者產生修補程式之後。
• 結束工作階段時。
• 距離上一次記憶檢查點超過 30 分鐘後。

核心責任

• 在 .ai/memory/ 中維護專案記憶。
• 在 .ai/state.json 中維護機器可讀狀態。
• 強制執行 Git 紀律：自動初始化、暫存與提交。不要只是提及 Git，而是實際執行。
• 保護分支安全。
• 摘要已變更的檔案。
• 絕不自動推送、重設、清理、部署或執行破壞性命令。

啟動或恢復

1. 檢查 .ai/state.json 是否存在。
2. 如果 .ai/memory/ 檔案存在，則讀取它們。
3. 檢查 git status --short --branch。
4. 如果不是 Git 儲存庫，自動執行 git init。
5. 如果在 main 或 master 分支上，向使用者建議 ai/<task> 分支，但在獲得確認前不要建立它。
6. 在開始新工作之前，產生簡潔的恢復摘要。

輔助工具：

$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh resume

初始化記憶

當專案沒有記憶時使用輔助工具：

$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh init --task "..."

輔助工具會建立：

• .ai/state.json
• .ai/memory/PROJECT_MEMORY.md
• .ai/memory/SESSION_LOG.md
• .ai/memory/CHECKPOINTS.md
• .ai/memory/DECISIONS.md
• .ai/memory/TODO.md
• .ai/memory/PAPER_CONTEXT.md

如果目錄不是 Git 儲存庫，它也會執行 git init。

編輯之後

1. 執行 git status 與 diff 摘要。
2. 摘要已變更的檔案。
3. 如有需要，使用 cheap-code-delegate 進行低成本的檢查點草稿。
4. 自動寫入記憶檢查點。
5. 自動執行 git add -A 與 git commit -m "checkpoint: <summary>"。
6. 除非使用者明確要求或你傳遞 --push，否則不要推送。

輔助工具：

# 自動在本機提交
$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh checkpoint --summary "..."

# 自動提交並推送（需要明確意圖）
$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh checkpoint --summary "..." --push

論文專案

如果專案是論文或學位論文：

• 維護 .ai/memory/PAPER_CONTEXT.md。
• 追蹤摘要、引言、相關工作、方法、實驗、限制、結論、參考文獻、圖表、表格與方程式。
• 編輯後，提醒使用者檢查跨章節一致性、引用與編號。

自動執行

自動執行：

• 當目錄不是 Git 儲存庫時執行 git init。
• 檢查點時執行 git add -A。
• 檢查點時執行 git commit。
• 寫入 .ai/memory 檢查點。

需要明確的使用者確認

不要自動執行：

• git push
• git reset
• git clean
• 破壞性簽出
• rm -rf
• 部署
• 生產命令
• 建立除自動建議的 ai/<task> 分支以外的其他分支

參考資料

僅在需要時載入：

• references/memory-schema.md：.ai/ 檔案責任說明。
• references/git-safety.md：安全的 Git 工作流程。
• references/paper-projects.md：論文記憶指引。