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
• 破坏性 checkout
• rm -rf
• 部署
• 生产环境命令
• 创建除自动建议的 ai/<task> 分支之外的其他分支

参考资料

仅在需要时加载：

• references/memory-schema.md：.ai/ 文件职责。
• references/git-safety.md：安全的 git 工作流程。
• references/paper-projects.md：论文记忆指南。