正文预览
CASE 08 · 毕业项目
Pi 蓝皮书毕业项目
结果
你会把一个真实 GitHub 项目交给 Pi:先读需求和仓库,再用命名 Session 制定方案;人工批准后修改文件、运行测试、保存检查点;最后让另一个只读 Session 使用 Review Skill 独立复核,再由你完成最终验收。
项目不大,但链路完整。毕业标准不是“Pi 成功写了一篇文档”,而是你能解释每一步的边界,并用项目里的真实证据判断它是否完成。
这张图有三条硬规则:主 Session 不能批准自己的计划,审阅 Session 不能修改文件,最后是否通过由人判断。
这次要改什么
练习仓库使用 Pi 学习蓝皮书。任务是在参考手册中新增“任务完成检查表”,同时接入首页与侧栏。需求刻意限制为三个简体源文件、三个对应的繁体生成文件和一个本地检查点,足以练习真实项目流程,又不会把注意力带到复杂业务代码上。
可以先预览这三份材料;正式练习会从固定版本的克隆中复制它们:
安全边界
始终在新克隆的练习仓库中操作。全程不部署,不执行
git add、git commit或git push,也不读取凭据。命令里的工具白名单会减少可用工具,但不是操作系统沙箱。
第 0 阶段 · 准备隔离副本
在普通终端执行。下面的激活命令用于 macOS / Linux;Windows Git Bash 将 source .venv/bin/activate 换成 source .venv/Scripts/activate:
cd ~/Downloads
git clone https://github.com/xiaomoBoy/pi-bluebook.git pi-bluebook-graduation
cd pi-bluebook-graduation
git checkout --detach ea68e5f
npm ci
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements-dev.txt
npm run check:translations
git rev-parse HEAD
git status --short
如果 pi-bluebook-graduation 已存在,换一个新目录名,不要覆盖旧目录。初始 git status --short 应该没有输出。本页固定使用 ea68e5f 作为练习基线,准备阶段的 checkout 只用于切换到已验证版本;进入 Pi 以后不再执行