任务手册

AI Agent CLI 工作流

从审查 PR、查询数据库或部署 Worker 等具体结果出发选择工作流。

按目标系统和可接受的写入风险选择任务手册。

推荐起点

先从常见决策或工作流入手,再根据你的环境缩小命令与权限范围。

部署与云平台远程写入
先本地构建并创建预览,验证通过后再由用户明确批准生产发布。

交付可访问的预览和发布报告,不静默修改生产环境。

4 工具3 确认点
代码协作只读
收集 PR 元数据并在本地检查补丁,先报告 blocker,不自动评论或合并。

输出有证据的审查结果,并把发现与仓库写操作分开。

3 工具3 确认点
代码协作远程写入
把开放 Issue 读取为结构化数据,按证据和优先级分组,再提出变更建议。

把 Issue 队列整理为可执行报告,不丢失用户上下文,也不意外改变状态。

2 工具3 确认点

按任务浏览 AI Agent CLI 工作流

每个入口都是完整页面,包含清晰结果、操作边界和官方来源。

部署与云平台

部署与云平台远程写入
先本地构建并创建预览,验证通过后再由用户明确批准生产发布。

交付可访问的预览和发布报告,不静默修改生产环境。

4 工具3 确认点
部署与云平台远程写入
验证配置和构建输出,先本地或预览检查,再只向明确环境部署并完成验证。

把 Worker 发布到指定账户和环境,并保留明确的回滚目标。

3 工具3 确认点

代码协作

代码协作只读
收集 PR 元数据并在本地检查补丁,先报告 blocker,不自动评论或合并。

输出有证据的审查结果,并把发现与仓库写操作分开。

3 工具3 确认点
代码协作远程写入
把开放 Issue 读取为结构化数据,按证据和优先级分组,再提出变更建议。

把 Issue 队列整理为可执行报告,不丢失用户上下文,也不意外改变状态。

2 工具3 确认点

容器与 Kubernetes

容器与 Kubernetes只读
固定 context 和 namespace,只用 get、describe、logs 与权限检查,拒绝变更型子命令。

解释集群健康状况和可能原因,同时确保审计路径只读。

2 工具3 确认点

数据库

数据库只读
使用只读角色,以非交互方式运行 psql,并限制查询范围和输出格式。

回答数据库问题,不暴露凭证,也不修改数据。

2 工具3 确认点
数据库只读
先检查本地项目状态,明确 linked project,再用只读路径访问生产数据。

回答 Supabase 项目或数据库问题,不串错项目,也不绕过数据保护。

2 工具3 确认点

HTTP 与 Webhook

HTTP 与 Webhook远程写入
把测试事件转发到本地端点,触发已知 fixture,并验证签名处理和幂等性。

证明 Webhook handler 能处理测试事件,不触及真实客户或资金。

1 工具3 确认点
HTTP 与 Webhook本地写入
先用明确的方法、Header、Body、超时和保存的响应复现单个请求,再改客户端或服务端。

判断问题来自网络、认证、请求形状、服务端行为还是响应解析。

3 工具3 确认点
HTTP 与 Webhook本地写入
先限定少量 URL,再选择内容提取或浏览器自动化,并为每份结果保留来源。

采集任务所需的公开内容,不进行失控爬取或隐藏交互。

2 工具3 确认点

数据与文本

数据与文本本地写入
先检查输入形状,再编写确定性的 jq filter,验证结果后才考虑替换文件。

按目标 schema 生成有效 JSON,同时保留原始输入。

1 工具3 确认点
数据与文本本地写入
先 profile 文件,再用 DuckDB 或 csvkit 本地查询,并把分析结果与源文件分开保存。

用可复现命令回答表格数据问题,并清楚说明数据质量限制。

3 工具3 确认点

运维与基础设施

运维与基础设施本地写入
先限定时间、服务、文件和模式,再只收集解释事故所需的日志行。

找到相关错误序列,不暴露无关用户、密钥,也不读取无限生产日志流。

3 工具3 确认点

如何选择正确的指南

从结果出发

按目标系统和交付结果选页面,而不是只选熟悉的工具。

检查最高风险

只读、本地编辑、远程写入和破坏性操作需要不同的审查级别。

确认执行身份

明确命令会使用哪个账号、Token、集群 Context 或数据库角色。

保留恢复路径

优先选择把预览、验证、批准与回滚分开的工作流。

每份指南都会给你什么

输入与输出

了解 Agent 需要哪些上下文,以及必须返回哪些证据。

可复制步骤

执行边界清晰的命令,同时看到风险标签和预期结果。

审批与回滚

清楚看到人在哪里做决定,以及获批写操作失败后如何恢复。

接口替代方案

判断同一任务何时更适合 CLI、MCP 或直接 API。

继续浏览工具库

使用前检查命令、证据、输出格式和风险。

把工作流调整为适合当前编程 Agent 与审批模型的形式。

针对具体操作选择 CLI、MCP 或直接 API。