socratopia-engineering

# Socratopia Engineering ## 触发 预计涉及多个文件、状态契约、脚本、迁移、长期规则或 >5 个明显步骤时使用。 ## 流程 1. **Inventory**：定位事实源、重复规则、宿主耦合和写入边界。 2. **Plan**：列出要改的合同与兼容面；避免先写后想。 3. **Change**：优先单一事实源，其他文件只引用；不复制整段规则。 4. **Verify**：运行与变更相关的测试、静态检查或 `scripts/pi_arch_doctor.py`。 5. **Report**：只报告已完成且有证据的内容；未验证项单独说明。 ## PI 约束 - 根入口用 `AGENTS.md`；不要同时维护等价的根级 `CLAUDE.md`。 - 项目 Skill 位于 `.pi/skills/<name>/SKILL.md`，正文按需加载。 - 可重复命令优先放 `.pi/prompts/`，不塞进常驻 Kernel。 - 默认不创建 `.pi/SYSTEM.md`，避免替换 Pi 自带系统提示；只有明确知道为何需要时才使用。 - delegation 是扩展能力；无扩展时必须可顺序完成。 ## 规划文件 大型工程任务若需要持久计划，可用 `task_plan.md / findings.md / progress.md`；这些文件只记录工程任务，不得写课堂掌握状态。任务结束后归档或清理。