交付
用户给出目标和约束条件,然后期望获得一个已完成、已验证的结果,无需监督。当前指令和仓库规则优先于以下所有内容。用户的全局指令可能添加个人细节(机器限制、产品、审查机器人、语音);请遵循它们。
建立任务
- 读取仓库的 AGENTS.md/CLAUDE.md、相关架构、包清单和锁定文件以及当前 Git 状态。在编辑之前,检查任务的实际分支、基准、议题和任何现有的工作树。
- 确定可观察的验收标准:行为、配置、兼容性、UI 打磨、测试证据以及请求的交付方式。做出合理的可逆选择;仅询问有关重大歧义的问题。
- 独立的重大任务需要隔离的 Git 工作树。重用任务框架已为此任务创建的工作树。不要切换或重置共享检出。如果多个代理有意共享一个工作树,则需就文件所有权和一个 Git 写入者达成一致。先前的推到主分支请求不授权新的推送。
实现和验证
- 保持产品的身份。打磨现有界面,除非任务要求重新设计,否则不要重新设计它们。
- 在使用新的 API 之前,检查已安装的框架和 API 版本。对于不熟悉或对版本敏感的行为,请查阅当前官方文档,如果安装了 Context7,也请查阅该文档。
- 对于平台目标(游戏服务器、移动操作系统版本、浏览器引擎、运行时),请对照构建的实际目标和官方 API 检查兼容性。永远不要使用生产环境代替开发实例进行测试。
- 优先使用仓库的测试和构建命令。为行为变更添加有意义的回归覆盖,然后测试受影响的集成。对于 UI 工作,无需提醒即可使用
visual-qa。 - 在有益的情况下,并行进行独立的研究和编辑,并明确所有权。根据机器调整并发度:在运行超过一个繁重构建或渲染,或超过两个浏览器会话之前,检查 CPU 和内存。不要累积后台服务器或启动冗余的代理集群。
工程手册(pstack)
此技能保持为路由器。当安装了 Lauren Tan 的 pstack 插件时,请在任务内部使用其工程方法手册。大多数 pstack 技能仅限手动使用,因此请通过路径 <pstack>/skills/<名称>/SKILL.md 直接读取,而不是等待它们加载。在遵循任何 pstack 文件之前,每会话为您的框架读取一次适配器;它映射了 Cursor 工具、模型和路径名称。
为您的框架解析 <pstack>:
- Claude Code:
ls -d ~/.claude/plugins/cache/cursor-plugins/pstack/*/ | sort -V | tail -1。 适配器<pstack>/docs/harness/claude-code.md。模型表~/.claude/rules/pstack-models.md,自动加载。 - Codex:
ls -d ~/.codex/plugins/cache/tinderbox-pstack/pstack/*/ | sort -V | tail -1。 适配器<pstack>/docs/harness/codex.md。模型表~/.codex/pstack-models.md;在生成角色模型之前读取它。
如果两个路径都不存在,则表示未安装 pstack:无需它进行工作。
| 任务形态 | 读取并遵循 |
|---|---|
| 报告的缺陷 | skills/poteto-mode/playbooks/bug-fix.md |
| 测量到的缓慢,或需要推进的一个指标 | perf-issue.md, hillclimb.md |
| 泄漏、旋转或闪烁;已捕获的分析数据 | runtime-forensics.md, trace-forensics.md |
| 新行为;仅结构变更 | feature.md, refactoring.md |
| 经验性设计分支 | 使用 prototype.md 而不是询问用户 |
| 只读的“如何/为什么/我们确定吗” | investigation.md, skills/how, skills/why |
| 影响范围不明确的变更 | 在编辑之前使用 skills/blast-radius |
| 基准测试或加速声明 | 在报告之前使用 skills/benchmark-checklist |
| 没有可重复应用证明的项目 | skills/create-verification-skill(询问一次) |
| PR 标题、正文、发布说明 | 在起草完成后使用 skills/unslop |
手册路径位于 <pstack>/skills/poteto-mode/playbooks/ 下。在应用手册引用的每个 principle-* 叶子节点之前,先阅读它。
在 pstack 有差异的地方,以下规则胜出:
- 交付。 PR 创建、CI 和审查保留给
pr-follow-through和file-pr。pstack 的opening-a-pr、babysit和shipping手册仅作为参考资料。其自主部分不授权提交、推送、合并、外部消息或超出当前请求范围的部署。 - 资源。
arena、swarm、interrogate和architect的扇出上限为三个子代理,除非用户要求更多。编写代码的通道获得自己的工作树(Claude Code 中为isolation: "worktree",Codex 中为git worktree add)。跳过autopilot-full和orchestrate,除非用户明确要求它们。 - 模型。 模型表将 pstack 的角色映射到框架可以访问的模型。跨提供商的审查保留给
council。 - 缺失的 Cursor 组件。 未安装
cursor-team-kit。对于/deslop,请在可用时使用pr-review-toolkit:code-simplifier;对于control-ui,使用visual-qa和playwright-cli;对于control-cli,直接运行 CLI。按照适配器的说明,用一句话跳过 Bugbot、Cursor 自动化和云代理步骤。 - 语气。 可以按原样使用 pstack 的回复规则(短句,无长破折号,证据标签)。将其首次消息的目标重述限制为两个句子。
完成
- 当请求包含 PR 或审查修复时,使用
pr-follow-through。 - 仅当当前任务授权该操作时,才进行提交、推送、创建发布或合并。首先检查仓库的发布自动化;不要假设发布是如何切割的。
- 报告实际结果:URL、测试场景、证据链接、失败以及任何真正需要用户操作的事项。未经检查,不要声明预览、平台构建、发布或审查已通过。
- 在上下文重置或长时间等待之前,在跟踪源之外留下简洁的交接说明,例如任务的
.agent-artifacts/HANDOFF.md。包括分支/工作树、目标、已完成的更改、命令/结果、PR/头 SHA、阻塞项、拥有的文件、资源/会话名称以及确切的下一个操作。切勿包含令牌。 - 仅停止您拥有的服务器和浏览器会话。保留有用的证据,避免删除不相关的工作树、缓存或用户工作。