@adlc/premortem

中文文档
1.12.0发布于 2026/10/10MITES Module构建来源已验证近 30 天下载 8220

故障第一谱应力测试——倒置为地表故障模式(C2/P1).

中文使用文档
文档目录10 节
  1. 使用量
  2. 参数
  3. 实例
  4. 退出代码
  5. 输出格式
  6. 已进入ADLC阶段
  7. LLM 配置
  8. 记录操作员的快速裁决
  9. 核心差距
  10. 与兄弟姐妹工具的关系

@adlc/ 临死前

失败的第一谱压力测试—— ADLC C2 / P1 门。 。 。 .

颠倒:它不问“这个计划有什么问题吗?” 前沿模型项目已经失败,要求它写出死后. 模型产生混凝土,可核查的风险 锁定在实际的光谱 内容。 产出反馈作为下一次P1审查的审讯问题.

运行一次每个光谱。 贱. 无需作出明确的判断.


使用量

premortem <spec.md> [--tier cheap|mid|frontier] [--out report.md] [--json] [--prompt-only] [--record-verdict <file|-> --ticket <id>]

参数

参数/ 旗帜说明默认
<spec.md>用于分析的 spec 文件的路径 (必须)—— 说
--tier型号等级 : cheap, (中文(简体) ), mid,或 frontierfrontier
--out <path>将标记下的报告写入此文件而不是 stdout静态
--jsonEmit 机器可读 JSON { causes: [...] }虚假
--prompt-only打印精确的系统 + 用户提示, 然后退出 0 - 不需要 API 密钥虚假
--record-verdict <file|->与 --prompt-only:从 <file> (或时叫: -并记录为 .adlc/manifest.jsonl 通过 gate-manifest。要求 --ticket ——无约束记录可以满足另一张票的P1门—— 说
--ticket <id>将记录的判决绑定在(需要使用) --record-verdict(中文(简体) )—— 说
--help打印使用和退出 0虚假

实例

# Run against a spec, print to stdout
premortem specs/checkout-v2.md

# Write the report to a file
premortem specs/checkout-v2.md --out reports/premortem-checkout.md

# Machine-readable output for orchestrators
premortem specs/checkout-v2.md --json

# Inspect the prompt without spending tokens
premortem specs/checkout-v2.md --prompt-only

# Use a cheaper model for quick iteration
premortem specs/checkout-v2.md --tier mid

退出代码

代码含义
0成功编写的报告(或 --prompt-only 编号 : --help(中文(简体) )
1操作错误 — 缺少 spec 文件, 没有配置 LLM 提供者, 模型响应错误
2(保留供今后闸机故障使用;目前未出)

输出格式

默认的减记报告包含:

  1. 失败原因表 原因、最早的可观测信号和每个物品的预防.
  2. 讯问问题 ——编号的审讯问题清单,每个原因一个,准备贴入下一次P1光谱审查.

已进入ADLC阶段

C2 — P1应力测试. 座落在P1(选取批准)阶段后. 之后 光谱已经通过 speccheck (C1级), premortem 运行一个前沿模型 完成对抗性尸检 由此产生的问题是: 在锁定光谱前附在光谱审查清单后.


LLM 配置

该工具要求:

ANTHROPIC_API_KEY   → uses claude-opus-4-8 at frontier tier
OPENAI_API_KEY      → uses gpt-5.1 at frontier tier
GEMINI_API_KEY      → uses gemini-2.5-pro at frontier tier

强制提供者: ADLC_PROVIDER=anthropic 按级别覆盖模型 : ADLC_MODEL_FRONTIER=claude-opus-4-8

使用 --prompt-only 以获得准确的提示 粘贴到任何绳索 当没有 键可用.


记录操作员的快速裁决

Claude Code(以及没有赤裸的API密钥的类似用具) --prompt-only 死前的运行情况是正常的:工具打印出故障模式的提示,以及 操作员(模型本身)回答并应用判断。 无 --record-verdict自我评估的判决 以及任何令人难以接受的判决 ——从不进入审计线索;只有及时 打印为可观察到的. --record-verdict <file|-> 关闭空格: 如常打印提示,它会读取操作员的回答 <file> (或 时间 -并记录到 .adlc/manifest.jsonl 通过 @adlc/gate-manifest属于自己的 record() - 重新使用散列链/签名 逻辑而不是重用它.

# Operator writes their conclusion to a file, then records it
premortem specs/checkout-v2.md --prompt-only --record-verdict verdict.txt --ticket T1

# Or pipe the answer straight from stdin
echo "confirmed: process.chdir throws under vitest threads pool" \
  | premortem specs/checkout-v2.md --prompt-only --record-verdict - --ticket T1

--record-verdict 需求 --prompt-only (另1出)和 --ticket (除去1外——p1门的瞄准镜为spec-lint/事前证据) 罚单,所以没有限制的记录 可以满足不同的罚单 核准)。 记录的条目 gate 实值 premortem, (中文(简体) ), data.verdict 持有 操作员的文字逐字,以及 data.specPath 记录 快速覆盖.


核心差距

无。 所有需要的功能(complete, (中文(简体) ), extractJson, (中文(简体) ), detectProvider, (中文(简体) ), promptOnly, (中文(简体) ), opError, (中文(简体) ), parseArgs, (中文(简体) ), printJson, (中文(简体) ), readStdin) 可在 @adlc/core. 记录只使用即时判决的再利用情况 @adlc/gate-manifest是因为 record() 直接( 见 lib/verdict.mjs而不是重新实施 散列链/ 签名逻辑 .


与兄弟姐妹工具的关系

  • 光谱检查 (C1) ——运行前 premortem;确保每一项接受标准都有核查方法.
  • 冷启动( C3) ——紧接着跑 premortem;压力测试个人票 丢失信息.
  • 临死前 咨询( a)exit 0 / 失败。 未来的一体化可以促进标有标记的问题进入门票和大门 coldstart。 。 。 .

版本与发布记录

@adlc/premortem 共发布 18 个版本,首次发布于 2026/06/14;过去 12 个月发布了 18 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.12.0latest2026/10/1027 天前
1.11.12026/09/091 个月前
1.11.02026/08/252 个月前
1.10.02026/08/112 个月前
1.9.02026/08/092 个月前
1.8.02026/08/082 个月前

关于 @adlc/premortem 的常见问题

@adlc/premortem 是什么?

故障第一谱应力测试——倒置为地表故障模式(C2/P1).

如何安装 @adlc/premortem?

在项目目录运行 npm install @adlc/premortem,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 premortem,可以用 npx premortem 直接运行。

@adlc/premortem 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/adlc__premortem 是否存在。

@adlc/premortem 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@adlc/premortem 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@adlc/premortem 可以商用吗?

@adlc/premortem 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@adlc/premortem 的下载量有多少?

根据 npm 官方下载统计,@adlc/premortem 在 2026/10/05 – 2026/11/03 这 30 天内被下载 8,220 次,日均约 274 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@adlc/premortem 还在维护吗?

最新版本 1.12.0 发布于 2026/10/10(27 天前);至今共发布 18 个版本,其中过去 12 个月发布了 18 个;首次发布于 2026/06/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。