# @adlc/premortem 中文文档

规范地址：https://npmcn.com/package/%40adlc/premortem/

版本：1\.12\.0
npm 元数据更新时间：2026-10-10T03:04:48.769Z
中文译文更新时间：2026-11-06T00:22:21.965Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40adlc/premortem
原文对照：https://npmcn.com/package/%40adlc/premortem/?lang=original
项目主页：https://github.com/voodootikigod/adlc/tree/main/packages/premortem#readme
源码仓库：https://github.com/voodootikigod/adlc

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：21.2 kB，8 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：2 个
- 首次发布：2026-06-13T21:12:44.649Z
- 最新版本发布：2026-10-10T03:04:48.438Z
- 近 30 天下载量：8220（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

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

## 安装

```sh
npm install @adlc/premortem
```

也可以使用：`pnpm add @adlc/premortem`、`yarn add @adlc/premortem`、`bun add @adlc/premortem`

## README

# @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`,或 `frontier` | `frontier` |
| `--out <path>` | 将标记下的报告写入此文件而不是 stdout | 静态 |
| `--json` | Emit 机器可读 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 | 虚假 |

### 实例

```bash
# 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()` - 重新使用散列链/签名 逻辑而不是重用它.

```sh
# 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 是什么？

故障第一谱应力测试——倒置为地表故障模式\(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 和提交记录判断。