本页内容

实战演示

从一段有测试的代码出发,依次审查、修改、验证,再把检查任务交给子代理或自动化脚本。

准备示例项目

以下命令在系统临时目录创建一个独立项目,用 Git 暂存原始文件作为比较基线,不创建提交。函数直接相加浮点数,测试包含金额精度边界。 保留终端中打印的路径;桌面端可以选择这个目录作为工作区。

TERMINAL
DEMO_DIR="$(mktemp -d)"
cd "$DEMO_DIR"

cat > subtotal.mjs <<'EOF'
export function subtotal(prices) {
  return prices.reduce((sum, price) => sum + price, 0);
}
EOF

cat > subtotal.test.mjs <<'EOF'
import test from 'node:test';
import assert from 'node:assert/strict';
import { subtotal } from './subtotal.mjs';

test('empty list', () => assert.equal(subtotal([]), 0));
test('whole and decimal prices', () => assert.equal(subtotal([12, 3.45]), 15.45));
test('decimal precision', () => assert.equal(subtotal([0.1, 0.2]), 0.3));
EOF

git init -q
git add subtotal.mjs subtotal.test.mjs
printf 'Demo project: %s\n' "$DEMO_DIR"

先在该目录执行测试,观察初始失败,再启动 Mica:

TERMINAL
node --test subtotal.test.mjs
mica

node --test 对初始的 0.1 + 0.2 精度断言会返回非零退出码,这是示例的起点。 后续示例都在这个目录执行;暂存区存的是原始文件,git diff 展示之后对已跟踪文件的修改。 使用源码入口时,按源码运行说明从此目录启动。

演示一:只读审查

输入:在终端或桌面对话中发送以下请求。它限定审查范围和输入约定,并要求报告可验证的证据。

TEXT
请只读审查 subtotal.mjs 和现有测试,不修改文件。
输入约定:价格非负,最多两位小数。运行 node --test subtotal.test.mjs,
报告发现的问题、触发输入、文件位置和实际测试结果;区分未验证的推测。不要改动 Git 暂存区。

过程:查看 Mica 阅读的文件和实际运行的测试。收到回复后,对照代码、失败的断言和测试输出核实;运行 git status --short、git diff 和 git diff --cached 检查工作区及暂存区。

验收:结果应能定位精度问题并说明测试是否运行成功或失败。只读是任务要求,不是文件权限隔离; 如需强制禁止写入,请使用受限环境并检查工作区是否发生变化。

演示二:修复并验证

输入:在同一会话继续发送以下请求,让模型使用刚才的检查上下文。

TEXT
修复刚才发现的金额精度问题,保留函数签名和空数组行为。
价格按非负、最多两位小数处理;不要通过删除断言掩盖失败,也不要改动 Git 暂存区。
补充必要的边界测试,运行 node --test subtotal.test.mjs,
检查最终 diff,说明修改、实际验证结果和仍未覆盖的情况。

过程:等待任务完成,阅读修改和测试记录。也可以退出或另开终端,在示例目录自行复核:

TERMINAL
node --test subtotal.test.mjs
git diff -- subtotal.mjs subtotal.test.mjs
git diff --cached -- subtotal.mjs subtotal.test.mjs
git status --short

验收:以实际测试退出码、修改内容和未覆盖场景为准。确认新增测试没有掩盖原有断言;若验证失败, 将具体输出交回同一会话继续处理。这里的价格约定只覆盖非负、最多两位小数的输入,不代表通用财务计算方案。

演示三:并行审阅

前提:启用 subagent 插件及对应会话能力。两项检查均为只读,适合在修复前或修复后执行; 在当前会话发送:

TEXT
请使用子代理并行做两个只读检查,不要修改文件:
1. 审查 subtotal.mjs 对非负、最多两位小数价格的处理,报告具体触发条件。
2. 审查 subtotal.test.mjs 的边界覆盖,提出可执行的测试建议。
等待两项结果后,核对原文件与实际测试,再汇总有证据的结论;
如果子代理不可用,请说明并在主会话完成检查。

过程:终端可用 /task 查看运行状态;桌面端可查看子代理详情。 主会话需要等待结果并核对证据,子代理返回文本本身不等于验证通过。

验收:检查汇总是否包含各项结论、文件位置和实际验证状态。子代理共享工作区:如将来分配写入任务, 先划分互不重叠的文件范围,或使用独立工作区。详情见协作方式。

演示四:消费自动化事件

前提:示例目录仍在当前 shell,mica models 能看到已配置的模型。 此示例发起一次只读检查,将 JSONL 和诊断日志保存在另一个临时目录,再用 Node.js 在进程结束后逐行解析。--no-save 不保存会话,但不禁止工具读写,提示词也不是强制的只读权限。

TERMINAL
LOG_DIR="$(mktemp -d)"
if mica exec --json --no-save --max-turns 12 \
  '只读检查 subtotal.mjs 和 subtotal.test.mjs,概述金额精度风险和现有测试;不要修改文件。' \
  > "$LOG_DIR/events.jsonl" 2> "$LOG_DIR/diagnostics.log"; then
  exec_status=0
else
  exec_status=$?
fi

if node - "$LOG_DIR/events.jsonl" "$exec_status" <<'NODE'
const { readFileSync } = require('node:fs');
const file = process.argv[2];
const exitStatus = Number(process.argv[3]);
let completed = false;
let text = '';
const errors = [];

for (const [index, line] of readFileSync(file, 'utf8').split('\n').entries()) {
  if (!line.trim()) continue;
  let event;
  try {
    event = JSON.parse(line);
  } catch {
    errors.push('Invalid JSON on line ' + (index + 1));
    continue;
  }
  if (!event || typeof event !== 'object') {
    errors.push('Invalid event on line ' + (index + 1));
    continue;
  }
  if (event.type === 'item.completed' && event.item?.type === 'agent_message') {
    text = event.item.text; // 完整累计文本;替换而不是追加
  }
  if (event.type === 'turn.completed') completed = true;
  if (event.type === 'error') errors.push(event.message || 'Unknown error');
  if (event.type === 'turn.failed') errors.push(event.error?.message || 'Turn failed');
}

if (exitStatus !== 0) errors.push('Process exit code: ' + exitStatus);
if (!completed) errors.push('Missing turn.completed');
if (errors.length) {
  console.error(errors.join('\n'));
  process.exitCode = 1;
} else {
  console.log(text || '(No agent text)');
}
NODE
then
  parse_status=0
else
  parse_status=$?
fi
printf 'Events and diagnostics: %s\n' "$LOG_DIR"
(exit "$parse_status")

过程:解析器记录 agent_message 的完成文本,检查 error、结束事件与进程退出码。 若运行失败,查看打印出的目录中的 diagnostics.log 和 events.jsonl。这些文件可能包含项目内容, 按本地工作数据管理。

验收:退出码为零且有 turn.completed 表示运行正常结束,不等于代码或测试通过; 仍需核对回复、实际文件与测试。大量输出或实时界面应改用逐行流式读取;不要把工具投影中的占位退出码当作命令执行结果。 字段语义、错误处理和 app-server 的持续会话见自动化与协议。

继续探索

在自己的项目中,先写清工作目录、允许的修改范围和验证命令,再参考日常开发流程管理长任务。需要复用审查步骤时,可以把它整理成项目 Skill。

文档随项目持续更新编辑此页