pstack for Codex 刻意工程工作流

这是什么？适合谁？

pstack for Codex（Aqua-123/pstack-for-codex）是 pstack 的 Codex 原生衍生版：把「刻意工程」（deliberate engineering）流程打包为 45 个显式 Skill + 23 个 Poteto Mode 工作流剧本。

核心价值：让 AI 编码从「即兴发挥」变成「可审计的工程流程」。普通 Agent 写代码是黑盒，做完说不清「为什么这么做、中间经历了什么」。pstack-for-codex 用工作流剧本把任务拆成可验证的步骤，每步记录产出，按需调用更窄的 Skill，父任务保留集成与提交权限——代表「可审计工程工作流」的新范式。

适合人群：

• 想让 AI 编码过程「可审计、可复盘」的团队
• 需要规范化 Agent 工作流的工程负责人
• 用 Codex 做生产级开发、看重过程质量的人

使用前提：OpenAI Codex；理解「工作流剧本」与「Skill」的分工。

准备工作

1. OpenAI Codex：这是 Codex 原生衍生版，需 Codex 环境。
2. 安装方式：通过 Codex 插件市场分发（具体安装见仓库 README）。
3. 成本：MIT 开源免费；Codex 使用费另计。
4. 时间预算：安装 + 跑通第一个剧本约 15 分钟。
5. 心智准备：核心是「可验证步骤 + 记录产出」，不是追求快，而是追求可审计。

4 步核心流程

第一步：安装与接入 Codex

通过 Codex 插件市场安装 pstack-for-codex，接入你的 Codex 环境。安装后即可使用 $poteto-mode 命令选取工作流剧本。

关键设计：父任务保留「集成与提交」权限——子任务只负责执行，不越权提交。

第二步：选取工作流剧本

用 $poteto-mode 从 23 个 Poteto Mode 剧本中选取适合当前任务的流程。每个剧本定义了一组可验证的步骤序列，告诉你「这一步该做什么、怎么算完成」。

预期产出：一个明确的步骤序列，取代「让 Agent 自由发挥」。

第三步：按可验证步骤执行

按剧本逐步执行，每步记录工作产出。遇到具体子任务时，按需调用 45 个更窄的显式 Skill 完成——窄 Skill 比宽泛指令更可控、更不容易跑偏。

预期产出：每一步都有记录、可验证、可复盘。

第四步：父任务集成与提交

父任务汇总各步骤的产出，完成集成，并在保留提交权限的前提下完成提交。

预期产出：一次端到端、可审计的完整改动。

常见踩坑

踩坑 1：跳过剧本直接让 Agent 自由发挥

• 现象：装了却不走工作流剧本，又回到黑盒模式。
• 原因：嫌麻烦，直接下宽泛指令。
• 解决：坚持用 $poteto-mode 选剧本，让步骤可验证。

踩坑 2：忽视「记录产出」

• 现象：步骤执行了，但产出没记录，事后无法复盘。
• 原因：只求快，不留痕。
• 解决：每步记录产出，这是「可审计」的核心。

踩坑 3：混淆父任务与子任务权限

• 现象：子任务越权提交，或父任务不保留集成权。
• 原因：没理解「父任务保留集成与提交权限」的设计。
• 解决：明确父子任务边界，提交权限只留父任务。

踩坑 4：窄 Skill 没用好

• 现象：所有子任务都用宽泛指令，窄 Skill 闲置。
• 原因：不理解「窄 Skill 更可控」的价值。
• 解决：具体子任务按需调用对应的窄 Skill。

踩坑 5：期待它提升速度

• 现象：觉得流程化后反而变慢。
• 原因：它优化的是「可审计性」与「质量稳定性」，不是纯速度。
• 解决：适合生产级 / 团队协作场景，追求质量与可追溯。

常见问题 FAQ

Q1: 和原生 pstack 什么关系？

A: 这是 pstack 的 Codex 原生衍生版，针对 Codex 生态做了原生适配（具体差异以仓库 README 为准）。

Q2: 45 个 Skill 和 23 个剧本有什么区别？

A: 剧本是「流程」——定义可验证步骤序列；Skill 是「能力」——执行具体子任务的窄工具。两者配合使用。

Q3: 免费吗？

A: MIT 开源免费；Codex 使用费另计。

Q4: 为什么强调「可审计」？

A: 生产级开发需要知道「Agent 为什么这么做、中间经历了什么」，可验证步骤 + 产出记录让过程可复盘。

Q5: 只支持 Codex 吗？

A: 是 Codex 原生衍生版，通过 Codex 插件市场分发。

参考链接

• 官方仓库

---

最后更新：2026-08-28 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成