---
title: "适合交给 TUI 的仓库任务"
description: "用任务边界、权限、可见过程和验证条件判断 Peri 适合做什么，以及何时应停下来由人决策。"
---

> Documentation Index
> Fetch the complete documentation index at: https://konghayao.github.io/peri-cool/llms.txt
> Use this file to discover all available pages before exploring further.

# 适合交给 TUI 的仓库任务

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

## 陌生仓库先只读探索

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

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

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

## 有复现条件的缺陷进入修改

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

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

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

## 跨文件功能需要阶段验收

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

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

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

## 缺少授权或验证时应停下

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

- 目标依赖产品取舍，但没有决策人给出标准。
- 操作会删除不可恢复数据、发布制品或影响外部用户，却没有明确授权。
- 结果只能靠人工审美或线上指标判断，当前没有验收人和观测窗口。
- 工作区包含生产凭据或敏感数据，却没有隔离和备份。

> **权限模式不是授权来源**
>
> TUI 允许某个工具运行，只表示当前审批策略放行。它不能替代业务授权、代码评审、发布审批或操作系统隔离。相关边界见[凭据与权限](/peri-cool/docs/security/secrets-and-permissions/)。

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

## 交付质量在 TUI 中可见

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

1. 输入能描述范围和禁止事项。
2. 工具过程能在消息区观察。
3. 敏感操作有明确审批人。
4. 完成状态能由 diff、测试或外部事实验证。

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

继续阅读 [在 TUI 中快速上手](/peri-cool/docs/get-started/quickstart/) 和 [查看产品概述](/peri-cool/posts/product/demo-introducing-peri/)。

Source: https://konghayao.github.io/peri-cool/posts/product/where-peri-fits/index.mdx