# 历史决策记录与可选保存

当前职业、团队和理解任务不要求创建决策记录。直接回答或使用用户自己的文档即可；只有用户要恢复旧草稿、处理已有文件或明确需要这个格式时，才使用本说明与离线脚本。普通阅读完成不需要 `nextActions`、完成状态或schema。

## 恢复已有记录

网站 `/decisions` 是旧记录恢复与导出入口，提供回到职业目录和公开资料的链接。旧localStorage草稿不静默清除，不以当前模块版本或已移除的角色/方案选项阻止原样取回。旧JSON/MD保留原版本、全部字段、额外备选、备注、逐条证据引用与成员标签；无法解释的旧引用可以提示，但不能悄悄替换成当前依据。

恢复与重新分析是两件事。用户要继续分析时再从manifest核对最新资料，说明哪些依据变化以及是否影响结论；更新结果另存，保留原件。导入失败不覆盖已有草稿或预览，读取、下载或复制不向网站发送私有内容。

离线工具保留以下能力；在安装后的Skill目录运行，或使用脚本绝对路径：

```bash
python3 scripts/decision-record.py check my-decision.json
python3 scripts/decision-record.py export my-decision.json --out my-decision.md
```

脚本不联网，只验证格式与记录内版本对应，不确认公开ID当前存在，也不证明建议正确。已有Markdown末尾若附完整JSON，可保留其原文后在用户工具继续。

## 用户明确选择旧格式时

[JSON模板](../assets/decision-template.json)和 `scripts/decision-record.py new --purpose career --domain computing --out my-decision.json` 仍可使用。`purpose` 可为 `career|team|understand`，`domain` 可为 `computing|finance|math|analysis`。这是可选笔记工具，不是网站或Agent分析的通用完成标准。

旧 `schemaVersion` 为 `edgeofwork.decision.v1`。共同字段有 `purpose/domain/status/completionLabel/createdAt/moduleVersions/resourceRefs/context/alternatives/evidence/unknowns/nextActions`；`context`为字符串对象。每条资源引用保留 `module/type/id/version` 与可选关系，记录内版本须对应 `moduleVersions`。证据状态 `documented|self_reported|unknown` 分别表示有材料可核、自述、未提供，documented不等于独立验证。

共享比较在 `context.comparison`，每个备选的实际理由在 `alternatives[].reason`；没有单独理由不能反推没有比较。可选 `notes`、额外备选和证据保持原样；不要自动拆解或改写旧理由。`createdAt`支持日期或带秒的ISO时间戳。

旧目的分支如下，仅供兼容：

- `career`：`selectedRoleIds[]`、`selectedJobIds[]`、`target`、`jobAssessment`、`evidencePlan`。
- `team`：`selectedOptionId`（可为null）、`selectedMemberIds[]`、`nowPlan`、`yearOnePlan`、`yearThreePlan`、`staffingChoice`、`memberAssessment`；`yearFivePlan`为2026-10-19增加的可选字段。
- `understanding`：`summary`、`impact`、`watchNext`。

草稿允许空值。旧 `ready_for_next_step` 至少需要一条下一步，只表示格式中已写下一步，不表示判断成立、求职/招聘成功或实际工作完成；没有下一步不妨碍当前读者完成理解。旧角色ID保留其历史身份，不改成新职业ID。旧字段不能容纳当前分析时使用普通文档，勿强塞或丢失信息。

执行回执继续见[回执方法](receipt.md)。旧反馈 `taskId/taskVersion`、`forecastId/frontierVersion` 按原CLI处理，职业目录、切片、观察与决策JSON不冒充旧反馈输入。任何私有记录都不放入公开分享链接或canonical。