适合交给 TUI 的仓库任务

用任务边界、权限、可见过程和验证条件判断 Peri 适合做什么，以及何时应停下来由人决策。

编写于 2026-08-13

打开 Peri TUI 后，输入框可以接住从解释代码到跨文件重构的任务。决定任务是否适合交给 Peri 的，不是它听起来有多复杂，而是范围能否说清、过程能否观察、结果能否验证。四个常见场景可以用同一判断方式检查。用户说什么，TUI 中会看到什么，最后依据什么验收。

陌生仓库先只读探索

先从一个不修改文件的任务开始，可以观察 Peri 读取哪些入口、怎样搜索、结论是否能回到源码。以下输入是演示示例，不是真实会话。

梳理这个项目从命令入口到数据库写入的调用路径。
不要修改文件。每个结论都列出实际读取的文件，并指出不确定部分。

消息区会出现文件读取、搜索和分析结果。完成标准不是一张漂亮架构图，而是关键路径能被文件和符号核对，未知部分没有被猜成事实。更多例子见探索代码库。

缺陷任务要在输入里写清复现步骤、期望行为、修改范围和回归测试。Peri 可以先运行复现，再修改和验证。以下输入是演示示例，不是真实会话。

用户取消后台任务后，状态栏仍显示运行中。
先用现有测试复现，只修改 TUI 状态聚合路径；补回归测试并运行目标测试。

执行中，你会看到读取、测试失败、编辑、测试通过或新的错误。审批弹窗可能要求确认敏感命令。最后要检查复现是否从红变绿，以及修改有没有越过指定范围。操作清单见修复缺陷。

跨文件功能可以交给 Peri，但应拆成几个能独立验证的阶段。先确认契约和基线，再实现主路径，最后补错误路径和整体验证。以下输入是演示示例，不是真实会话。

为会话列表增加删除操作。
先确认协议和存储边界，给出分阶段计划；每阶段结束运行目标测试。
不要改变已有会话恢复语义。

复杂任务可以使用子代理或工作流，但这些机制不会替代主会话的验收。用户仍要看到每个阶段改了什么、运行了什么、哪些检查没有覆盖。参考实现功能和并行执行。

有些任务应停在分析或计划阶段。常见边界包括以下四类。

遇到这些情况，让 Peri 停在只读分析或计划阶段，列出需要谁决定、缺少什么证据。一个清楚的阻塞报告比未经授权的完成更有价值。等待决策期间，不要扩大工具权限来绕过阻塞。

交给 Peri 持续推进的任务通常具备四个条件。

回到最初的 TUI 输入框，判断标准不再是任务大小。只读理解、可复现缺陷和分阶段功能都能形成验证闭环；缺少授权、不可逆或无法验收的任务，应先交还给人做决定。