模拟 Lagune 命令
本技能之所以存在,是因为模拟命令极其容易出错,从而浪费用户的时间和信任。经过多次艰难的对话,我们总结出四条不可妥协的规则以及一套方法。请严格遵循。
当用户要求“模拟”、“演示”、“实践展示”、“运行”或“实际体验”任何 /lagune.* 命令(charter、detect、plan、harden、verify),或者想在正式交付前预览命令的行为时,请使用本技能。
开始之前(强制要求)
在完成下面两项之前,切勿开始模拟、构建场景或复制夹具。请按此顺序处理:
- 用户必须告知要模拟哪个 Lagune 命令。 这是必须的,切勿假设或自行选择一个。如果用户没有指定命令(
charter、detect、plan、harden或verify),请先询问,然后再进行任何其他操作。如果他们指定了多个,请确认您将按什么顺序运行它们。 - 然后枚举可用的夹具,让用户选择。 一旦确定了命令,将可用的夹具(来自
.claude/skills/simulate/fixtures/)以编号列表的形式列出,每个夹具附带一行场景描述,并让用户通过编号选择。不要默默地默认使用某个夹具。即使只有一个夹具,也要先展示给用户,确认后再使用。如果没有夹具适合该命令,请说明情况并提供添加新夹具的选项(参见夹具部分)。
只有在命令被命名且夹具被选中之后,才能继续执行下面的规则和方法。
本技能存在的原因(请先阅读)
Lagune 命令不是独立的程序。它是一份指令文件(spec/commands/lagune.<phase>.md,作为 AI 代理可读取的技能来搭建),用于指导 AI 代理完成某个阶段的安全工作。“运行命令”意味着代理遵循这些指令。没有能独立于代理产生确定性结果的二进制程序。因此,“模拟”就是代理针对真实场景实际执行命令的步骤,同时展示其工作过程。
需要避免的失败模式:叙述您_想象_命令会输出什么,将其格式化为终端输出,然后像真正运行过一样呈现出来。那是表演。用户无法区分编造的输出和真实的输出,他们(合理地)会称之为闹剧。下面的所有设计都是为了确保模拟真实且可由用户验证,而非一场表演。
四条严格规则
规则 1:在 ./temp 下运行场景
将模拟所需的一切(夹具、各个阶段生成的 .lagune/memory/ 产物、任何输入)都构建在仓库根目录下的 ./temp 内,切勿放在系统的 /tmp 下。
/tmp对用户不可见:他们无法在编辑器中打开这些文件,所以您在里面的所有操作都变成了“相信我”。而./temp在工作区中,可打开,可检查。./temp已被加入.gitignore,因此模拟不会污染提交。- 当用户完成后,清理
./temp,或者留给用户检查,但需要先征得同意。
夹具:每次模拟都从一个夹具开始
中立的示例项目随本技能一同提供,每个项目都放在 .claude/skills/simulate/fixtures/<name>/ 目录下。选择场景与命令需求匹配的夹具,或添加新的夹具(见下文)。每个夹具都是一个小的、真实项目,故意同时包含健壮和脆弱的代码,且采用中立配对的方式,以便命令必须分析代码本身,而非读取标签。
可用夹具:
image-upload-service:一个接受图片上传、从远程 URL 导入图片并提供回看服务的小型 ESM HTTP 服务。template-toolkit:一个可发布的 ESM npm 包(一个库以及一个tmplCLI),用于渲染模板和解析文本。
每次模拟都从将某个夹具原始复制到 ./temp 开始。 如果 ./temp 已存在且非空,请先清空它,这样每次运行都是干净的(将 <name> 替换为您选择的夹具名称):
rm -rf ./temp && mkdir -p ./temp
cp -R .claude/skills/simulate/fixtures/<name>/. ./temp/
然后在 ./temp 之上按照规则 4 构建完整的链条,即真实地运行上游阶段,这样命令读取的 .lagune/memory/*.md 产物是由其自身阶段生成的,而非手写。按照规则 3 严格遵循其规范,对 ./temp 运行命令的步骤,并按照规则 2 展示每一步的输出。
要添加夹具,请创建 .claude/skills/simulate/fixtures/<new-name>/ 作为一个包含 package.json 的小型真实项目,保持健壮和脆弱代码的中立配对,不添加揭示性注释或名称,并将其列在上述列表中。当命令需要当前夹具未覆盖的场景(不同的语言或技术栈、密钥处理、认证、数据库等)时,添加新的夹具。
规则 2:在聊天消息中以围栏代码块展示提示和响应
这是花费最长时间才学会的规则。当您运行一个工具(Bash、Read)时,用户的界面会显示该工具的 IN 和 OUT 的截断预览。您无法控制显示多少,而且通常会被截断。如果支持某个说法的证据只存在于工具调用的输出中,用户是看不到的,您描述它的任何句子都会被认为是编造的。
因此:
- 运行工具后,将相关的原始输出复制到一个围栏代码块(三重反引号)中,放在您正常的聊天消息里。围栏代码块在所有界面中都能完整、一致地渲染。这就是用户所说的“黄色字母”:一个 Markdown 代码块。
- 命令的提示和交互(
/lagune.<phase>在运行时显示的内容:逐步过程、范围决策、判定结果)也放在一个围栏代码块中,格式类似转录文本。 - 切勿指着工具调用写“上面的输出显示 X”。要指向您粘贴的围栏代码块,用户可以完整阅读。
- 当您的转录文本中的某个数字或行来自真实运行时,它必须与您粘贴的原始输出匹配。如果您写了没有原始输出支持的转录行,那您就是在编造,请立即停止。
一个可靠的模式:运行命令,将原始输出重定向到 ./temp 下的一个文件(例如 ./temp/run.log),然后 Read 该文件(Read 的结果会完整展示给您),并将其内容粘贴到一个围栏代码块中。用户也可以打开 ./temp/run.log 来验证。
边做边展示,而不是在最后集中展示。 触发点是在每一步:一旦某一步产生了用户应该看到的内容(它读取的输入、其转录文本、它写入的产物),在进入下一步之前,立即将其粘贴到同一条消息的围栏代码块中。如果您即将开始下一个阶段或修复,而前一步的输出尚未展示在屏幕上,请停下来先粘贴。如果用户必须提醒您展示命令的输出,那么规则已经失败了。
规则 3:您就是命令,所以严格遵循其规范
“运行命令”是指您一步步地执行 spec/commands/lagune.<phase>.md,而不是凭自己的方式完成该阶段并称之为命令。
- 首先打开该规范,并将其视为唯一真理。 按顺序遵循其步骤。切勿凭记忆或本技能的摘要来运行阶段。
- 执行规范门控的每一个确认暂停,真实进行。
harden必须在编辑任何代码前进行确认,完整的detect扫描由于 token 消耗大也必须确认。在转录块中展示规范要求展示的内容,然后等待。未经确认,切勿编辑代码或运行门控步骤。 - 按照规范步骤决定的方式,针对真实场景,来决定范围、判定、修复、优先级和发现。如果您不能指出规范中的哪一步证明了输出的某一行,那您是在按自己的意愿行事,请停下来并遵循规范。
规则 4:每个阶段的输入必须来自运行前一个阶段,而不是来自您
链条是 charter → detect → plan → harden → verify,每个阶段都会读取前一个阶段写入的内容。手写一个包含您期望答案的下游产物(例如一个 harden.md 精确记录您希望 verify 确认或捕获的内容)是失败的:下游阶段随后将根据您的预测而非现实进行测试,因此它会遗漏您遗漏的任何东西。
- 通过运行其阶段来生成每个上游产物,在其自身的规范下,按照规则 2 展示。要演示
verify,请运行detect(读取代码),然后运行plan(读取detect.md),接着运行harden(读取plan.md,编辑代码)。即使用户从链条中间开始,也要按此顺序构建缺失的产物。 - 让产物说出运行实际产生的内容,包括缺口:一个
Partial、一个Blocked、一个您未预见到的发现。异常干净的产物是规则被打破的迹象。 - 故意偏离的场景是可以的(
harden应用了所有更改,然后代码被恢复,这样verify必须捕获偏差),但偏差必须可见地引入(在显示的工具调用中恢复,保留真实的产物),切勿通过手写一个运行从未产生的记录来引入。
方法,逐步说明
每个阶段读取前一个阶段的内容,并写入下表中显示的内容。请熟知此链条,不要打破它:
| 阶段 | 读取内容 | 写入内容 |
|---|---|---|
charter | 项目上下文 | .lagune/memory/charter.md |
detect | 代码 | .lagune/memory/detect.md |
plan | 仅 detect.md,绝不读取代码 | .lagune/memory/plan.md |
harden | 仅 plan.md 加上 charter,并编辑用户的代码 | .lagune/memory/harden.md |
verify | harden.md 和代码,将记录与现实对照,不更改任何代码 | 对 harden.md 块的 Verdict/Reason |
然后,对于您正在模拟的命令:
- 将夹具原始复制到
./temp(规则 1)。 - 通过对
./temp按顺序运行每个上游阶段来构建链条(规则 4)。 - 在其
spec/commands/lagune.<phase>.md下,严格遵循规则 3 运行目标阶段。 - 边进行边在围栏代码块中展示每个输入、转录文本和产物(规则 2)。将每个输出产物写为真实文件,然后
Read并展示它。
展示任何内容前的诚实检查
- 这真的运行过吗,还是我在输入我认为会发生的事情?
- 每行转录文本是否都有我粘贴的原始输出支持,或者是一个用户可以打开的
./temp文件,而非被截断的工具调用?(规则 2) - 到目前为止,我是否已经粘贴了每一步的输出,让用户永远不需要询问?(规则 2)
- 我是否遵循了每个阶段的规范,包括确认暂停,而不是按我自己的意愿行事?(规则 3)
- 每个上游产物是否都来自运行其阶段,而非我手写想要的结果?(规则 4)
- 场景是否在
./temp下,而不是隐藏在/tmp中?(规则 1)
如果任何一个答案为“否”,在发送之前修复它。用户宁愿看到真实、朴素的输出,也不愿看到精心编造的产物。