Communitygithub.com

wellwelwel/lagune

🌊 Lagune 是您的安全副驾驶,在您构建时保驾护航;也是您的蓝队伙伴,在您审计时提供支援——无论您是不是开发者。

lagune 是什么?

Lagune 技能专门用于模拟 Lagune 安全命令(charter、detect、plan、harden、verify)的执行过程。它解决了 AI 助手在“模拟”时常见的虚假输出问题,建立了一套严格的规则以确保每次模拟都是真实、可验证的执行。该技能要求用户必须先指定要模拟的命令,然后从预设的测试夹具中选择合适的场景。仿真过程完全在仓库根目录下的 `./temp` 文件夹中进行,所有生成的中间产物和日志文件都放在该目录下,方便用户查看和验证。核心规则包括:所有操作必须基于真实夹具、输出内容必须以代码块形式完整展示在聊天消息中、严格遵循对应命令的规范文档执行、以及每个阶段的输入必须来自上一阶段的真实运行结果。这确保了整个安全工作流(从章程制定到最终验证)的完整性和可追溯性。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add wellwelwel/lagune

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

模拟 Lagune 命令

本技能之所以存在,是因为模拟命令极其容易出错,从而浪费用户的时间和信任。经过多次艰难的对话,我们总结出四条不可妥协的规则以及一套方法。请严格遵循。

当用户要求“模拟”、“演示”、“实践展示”、“运行”或“实际体验”任何 /lagune.* 命令(charter、detect、plan、harden、verify),或者想在正式交付前预览命令的行为时,请使用本技能。

开始之前(强制要求)

在完成下面两项之前,切勿开始模拟、构建场景或复制夹具。请按此顺序处理:

  1. 用户必须告知要模拟哪个 Lagune 命令。 这是必须的,切勿假设或自行选择一个。如果用户没有指定命令(charter、detect、plan、harden 或 verify),请先询问,然后再进行任何其他操作。如果他们指定了多个,请确认您将按什么顺序运行它们。
  2. 然后枚举可用的夹具,让用户选择。 一旦确定了命令,将可用的夹具(来自 .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 包(一个库以及一个 tmpl CLI),用于渲染模板和解析文本。

每次模拟都从将某个夹具原始复制到 ./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
verifyharden.md 和代码,将记录与现实对照,不更改任何代码对 harden.md 块的 Verdict/Reason

然后,对于您正在模拟的命令:

  1. 将夹具原始复制到 ./temp(规则 1)。
  2. 通过对 ./temp 按顺序运行每个上游阶段来构建链条(规则 4)。
  3. 在其 spec/commands/lagune.<phase>.md 下,严格遵循规则 3 运行目标阶段。
  4. 边进行边在围栏代码块中展示每个输入、转录文本和产物(规则 2)。将每个输出产物写为真实文件,然后 Read 并展示它。

展示任何内容前的诚实检查

  • 这真的运行过吗,还是我在输入我认为会发生的事情?
  • 每行转录文本是否都有我粘贴的原始输出支持,或者是一个用户可以打开的 ./temp 文件,而非被截断的工具调用?(规则 2)
  • 到目前为止,我是否已经粘贴了每一步的输出,让用户永远不需要询问?(规则 2)
  • 我是否遵循了每个阶段的规范,包括确认暂停,而不是按我自己的意愿行事?(规则 3)
  • 每个上游产物是否都来自运行其阶段,而非我手写想要的结果?(规则 4)
  • 场景是否在 ./temp 下,而不是隐藏在 /tmp 中?(规则 1)

如果任何一个答案为“否”,在发送之前修复它。用户宁愿看到真实、朴素的输出,也不愿看到精心编造的产物。

相关技能