using-pythia

使用 pythia — 口袋手册

**阶段：**了解 → 提问 → 执行 — 本页会带你进入正确的阶段

pythia 是主手册；这是夹在封面里的小本子。 它只有一个职责：保持一致性——一次会话是否会提出正确的问题，不该取决于 Agent 当天的心情。

规则

只要 pythia 的某项技能有哪怕一点可能适用，就要在采取行动前打开它——回答前、探索前、提出澄清问题前都一样。 打开了错误的技能？关掉即可，不会有坏处。跳过检查才会让会话偏离轨道：有些会提问，有些却默默做出决定。

根据开发者的表述选择路径

请求听起来像	首先打开	然后
“构建 / 添加 / 更改 X”——且有任何待定决策	pythia-spec — 必须提出问题；可提供 spec/plan 文档，也可以跳过	影响分析 → 编写 → 应用
“解释 X / 为什么 / 它是如何运作的”	pythia-explore
“改动 X 安全吗”	pythia-impact
“创建一张表 / 添加一列 / 为列添加注释”（“tạo bảng”、“thêm cột”）	pythia-table	部署
“编写一个包 / 过程 / 触发器”（“viết package”）	pythia-package	编写 → 应用
“更改这个过程”——小幅修改，spec 已确定	pythia-impact，然后 pythia-write	应用
“它很慢 / 优化这个查询”（“chậm”、“tối ưu”）	pythia-tune	表或编写
“审查这个”	pythia-review
“合入 / 应用这个”——一条语句	pythia-apply
“运行这个脚本 / 部署这个版本”（“chạy script DDL”）	pythia-deploy
“不用问我，全部自动完成”（“tự động hoàn toàn”）	pythia-autopilot — 一次授权，不是空白支票	先做 spec
即将说“完成了”/“修好了”/“更快了”	pythia-verify — 先提供证据
“我们的标准 / 采用这个代码库的风格”	pythia-conventions
“为我们处理 X 的方式编写一个技能”	pythia-skill-author
设置、连接失败、权限警告、未收到审批	pythia-setup（pythia doctor）
即将在所改动的代码中编写注释	pythia-comment — 写一行，否则就应该放在别处
需要调查 ORA-/PLS- 错误	pythia-explore（errors、src）	pythia-review

多个技能都适用时的优先顺序：先流程，后构建——先 spec，再编写；先影响分析，再应用；先验证，再说“完成”。说出你打开的技能（“正在使用 pythia-spec — …”），让开发者知道你正在查看哪一页。会话开始时的 STATE 行会说明是否有 autopilot 授权生效——在决定写入是否需要审批前，先阅读这些行。

与其他工具包配合

本手册假设没有安装其他工具包。如果会话中启用了通用流程工具包（头脑风暴、TDD、规划），就让它负责通用流程，并保留 pythia 的 Oracle 关卡——两者可以配合使用。绝不要因为存在其他工具包就跳过 pythia-spec，也不要因为存在 pythia 就跳过其他工具包。

警示信号——导致“有些会话会提问，有些不会”的那些想法

想法	实际情况
“这个任务很简单”	简单任务也会隐藏 spec。一个“忘记密码”流程就包含 7 项未经询问的决策。
“我记得这个技能怎么说”	技能会不断更新。打开当前页面。
“我先随便看看”	pythia-explore 就是用来探索的。先选择路径。
“另一个工具包会负责提问”	如果它启动了，那很好；如果没有，pythia-spec 是底线。
“提问会拖慢开发者”	为未经询问的决策付出代价，拖得更久。

这个平台不支持技能？

pythia guide 会打印完整约定；pythia guide --brief 会打印本手册的首页，适合放在会话前言中。AGENTS.md 载有长期适用的规则。使用这本手册不要求 Agent 支持技能。

---

这一模式——采取任何行动前先查阅路由器——源自 Jesse Vincent 的 Superpowers，并为这个工具包从头重建。