Vetta
实战示例

04 / 实战示例

示例:批量审计多个项目

用同一套只读规则检查多个独立目录,通过试跑、产物校验和抽样复核控制批次质量。

READ / 带走

  1. 每个目标目录都必须能独立完成
  2. 先以并发 1 试跑代表性目录
  3. 固定产物只能证明文件存在,仍需抽查内容

这个示例检查多个项目是否具备清晰的开发入口。它只生成报告,不修改项目配置,适合作为第一次批量任务练习。

起始状态

准备 2–5 个彼此独立、结构具有代表性的项目目录。不要选择需要共享中间结果或必须按顺序处理的目标。

创建批量项目前

  1. 每个目录都可以由同一条任务独立审计。
  2. 目录中没有另一个正在执行写操作的任务。
  3. 已选出一个风险较低的代表性目录用于试跑。
  4. 报告文件名 vetta-project-audit.md 不会覆盖已有内容。

配置共享任务

更多 → 批量任务 新建项目,第一次只添加一个目录,并发设为 1,产物校验填 vetta-project-audit.md

PLATE 01

共享审计任务
审计当前项目的本地开发入口,只生成 vetta-project-audit.md,不修改其他文件。

请检查 README、项目清单、工作区配置和已有脚本,并在报告中写明:
1. 项目类型与主要运行时;
2. 安装、开发、测试、检查和构建命令;
3. 每条命令来自哪个文件;
4. 缺失、冲突或明显过时的说明;
5. 新贡献者从零开始的最短验证路径;
6. 无法静态确认、需要人工执行的事项。

不要安装依赖,不要运行可能产生外部副作用的命令,不要猜测不存在的脚本。
完成后确认 vetta-project-audit.md 存在,并重新读取它检查六个部分。

先试跑,再扩大批次

检查代表性目录

启动单个任务,进入它的会话,确认读取范围、报告结构和事实来源正确。

修正共享任务

如果项目类型差异导致要求不适用,把它改成明确的条件分支,不要为单个目录写隐藏例外。

添加其余目录

试跑通过后再加入剩余目录。先使用较低并发,观察模型限流和本机负载后再调整。

预期产物

每个目录顶层各有一份 vetta-project-audit.md,报告结构一致,但事实、命令和待确认项来自各自项目。批量看板显示每个子任务的独立状态和会话。

验收结果

接受整个批次前

  1. 任务总数与目标目录数一致,没有重复路径。
  2. 所有完成项都通过产物校验,失败项已进入对应会话定位。
  3. 随机抽查一个常规项目和一个结构不同的项目。
  4. 报告中的命令都能在对应配置或 README 中找到。
  5. 没有项目源码、清单或锁文件被修改。

结果不符合时恢复

单个目录失败时,先打开它的会话查看原因;修正共享提示后使用失败项的重试能力,不要停止并重置整个批次。若大量目录因同一要求失败,暂停扩大并发,回到一个代表性目录重新验证规则。

只修正当前审计报告中的 [具体问题]。保持只读,不修改项目文件。
先核对 [README 或配置文件],再更新 vetta-project-audit.md,并重新检查六个必需部分。

本页内容