restart-life

English | 简体中文

restart-life 是一个本地优先的「重启人生」技能包，用于把人生和职业决策从泛泛建议变成可追踪、可验证、可复盘的工作流。它为 Codex 和 Claude 提供中文优先、证据门控的 discovery、选择比较、实验执行、证据评审、整合更新和私有记忆写入链路。

项目通过 npm CLI 分发，也包含 Codex / Claude 原生 plugin 元数据。安装器会把公开的 11 个 skill 安装到目标项目里，但不会复制任何私有 runtime 数据。

目录

• 为什么做这个项目
• 功能特性
• 快速开始
• Skill 套件
• 架构合同
• 命令
• 关注趋势
• 开发
• 贡献
• 安全
• 开源协议

为什么做这个项目

多数人生规划 prompt 太容易直接跳到建议。restart-life 的目标是把证据和假设分开，并要求 agent 在给出持久结论前先走正确的工作流。

默认合同是：

• 没有可用 profile -> 先 discovery
• 严重困惑或痛苦 -> 先 investigate
• 多条方向竞争 -> 做 Odyssey 风格选择比较
• 已选择方向 -> 进入有边界的行动实验
• 有实验结果 -> 做 proof review
• 要写入长期记忆 -> 先过 memory-write gate

功能特性

• 一条命令安装：npx restart-life@latest init --dir <project>。
• 11 个公开 skill：覆盖 front door、DCAP、ICAP、roundtable 和 memory-write 工作流。
• Codex / Claude 兼容：可安装到 .agents/skills 和 / 或 .claude/skills，并包含 .codex-plugin 与 .claude-plugin manifest。
• 私有 runtime 边界：用户数据保存在 ~/.restart-life，不会进入 npm 技能包。
• 机器可检查质量门：profile、life-cycle、JSONL、runtime、panel、skill-pack 都有验证入口。
• 单文件 HTML 面板：无需服务端即可渲染本地私有进度视图。
• 项目根可读投影：--project-output 会把 RESTART-LIFE.md、restart-life-panel.html、restart-life/summary.md 写到当前项目根；这些文件都是 Generated projection，可删、可再生成。
• 安全更新：--force 只覆盖 restart-life 管理的文件，不碰目标项目里的无关内容。

快速开始

把完整技能包安装进一个项目：

npx --yes restart-life@latest init --dir /path/to/project

只安装到某一个 host：

npx --yes restart-life@latest init --dir /path/to/project --platform codex
npx --yes restart-life@latest init --dir /path/to/project --platform claude

检查安装状态：

npx --yes restart-life@latest doctor --dir /path/to/project

渲染本地面板：

npx --yes restart-life@latest panel --runtime ~/.restart-life

渲染项目根可读投影：

npx --yes restart-life@latest panel --dir /path/to/project --runtime ~/.restart-life --project-output

只有在你明确要覆盖 restart-life 管理的 skill 文件时才使用 --force。它不会删除或覆盖目标项目已有的无关 .agents 或 .claude 内容。

Skill 套件

公开安装器只复制 .agents/skills/restart-life-suite.json 中列出的 skill：

| Skill | 职责 | | --- | --- | | restart-life | 前门路由器；不直接写入持久用户数据。 | | life-discover | 基于证据建立第一个可用 profile。 | | life-roadmap | 只有在 profile 可用后才维护 roadmap 和 backlog。 | | life-investigate | 在给建议前先冻结真实问题。 | | life-principle | 把调查过的案例沉淀成可复用个人原则。 | | life-choose | 用 Odyssey 风格 decision brief 比较方向。 | | life-act | 把选择转成 7 天或 30 天行动实验。 | | life-prove | 评审实验证据，判断什么可靠。 | | life-integrate | 更新 durable profile、compass、roadmap 和 backlog。 | | life-roundtable | 在行动或整合前做可选盲点审查。 | | memory-write-gate | 用明确证据保护长期记忆写入。 |

npm-release 这类开发者专用 skill 不属于公开 npm 包，也不会被 init 安装到用户项目里。

架构合同

restart-life 明确分离四个世界：

| 世界 | 路径 | 合同 | | --- | --- | --- | | 源码技能包 | .agents/skills | 公开 skill 源码和套件元数据。 | | 已安装技能 | 目标项目 .agents/skills 和 / 或 .claude/skills | 由安装器 registry 管理的复制结果。 | | 私有 runtime | ~/.restart-life | 用户 profile、cycle artifacts、evidence、roadmap 和长期记忆真相源。 | | 项目根可读投影 | 目标项目 RESTART-LIFE.md、restart-life-panel.html、restart-life/ | 方便快速打开和查询的生成投影；默认忽略，可删、可再生成。 |

当前套件合同保持文件化和可审计：

• restart-life-suite.json 列出 11 个可见 skill，并声明 panel / evolution 元数据。
• 每个可见 SKILL.md 都包含入口检查、读取顺序、输出格式、质量门、重路由和禁止事项。
• 每个 skill 都拥有自己的 references/guide.md、assets/ 输出模板和 scripts/check-handoff.mjs。
• sourceLineage 与 guide 里的 ## 思想来源 用于在执行前激活正确的理论来源和人物框架。
• validate:profile 检查 profile.json、discovery-map.md 和 evidence ledger 引用。
• validate:life-cycle 检查 DCAP / ICAP artifacts，避免未经验证的内容成为长期真相。
• render:panel 从私有 runtime 生成只读单文件 HTML；它不是 dashboard server，也不是新的真相源。
• panel --project-output 使用 templates/project-output/ 生成项目根可读投影，避免素材 Markdown 的章节结构随对话漂移。
• evolve:skills 在 devflow/skill-evolution/ 下生成 Darwin 风格的 skill 进化包。

命令

node bin/restart-life-cli.js init --dir /path/to/project
node bin/restart-life-cli.js doctor --dir /path/to/project
node bin/restart-life-cli.js panel --runtime ~/.restart-life
node bin/restart-life-cli.js panel --dir /path/to/project --runtime ~/.restart-life --project-output

npm test
npm run validate:profile
npm run validate:life-cycle
npm run validate:skill-pack
npm run validate:runtime
npm run validate:cycles
npm run validate:jsonl
npm run validate:panel
npm run sync:check
npm run doctor

npm run render:panel -- --runtime ~/.restart-life --out ~/.restart-life/panel/restart-life-panel.html
npm run render:panel -- --repo /path/to/project --runtime ~/.restart-life --project-output
npm run evolve:skills -- --write
npm run validate:skill-evolution

关注趋势

开发

要求：

• Node.js 20 或更新版本
• npm
• Git

本地启动：

git clone https://github.com/Dimon94/restart-life.git
cd restart-life
npm test

提交前请运行与改动相关的最小验证，并至少运行 npm test。如果改动涉及安装器或发布链路，还应运行：

npm publish --dry-run --access public
tmpdir=$(mktemp -d /tmp/restart-life-npx-XXXXXX)
target=$(mktemp -d /tmp/restart-life-target-XXXXXX)
cd "$tmpdir"
npx --yes restart-life@latest init --dir "$target" --platform codex

路线图

• 随着 Codex / Claude plugin 生态稳定，完善原生 plugin 入口。
• 改进私有 HTML 面板，但不把它变成托管 dashboard。
• 增加更多高压力决策场景的 life-cycle fixture。
• 保持公开 skill pack 精简，持续排除维护者专用 workflow。

贡献

欢迎贡献。请先阅读 CONTRIBUTING.md。

适合开始的贡献方向：

• lifecycle fixture 和验证覆盖
• 中英文文档清晰度
• 安装器 managed-file 安全性
• skill handoff 检查

本项目使用 Conventional Commits。请保持每个提交聚焦，不要把 feature、test、docs 和 release 工作混在一个 commit 里。

安全

如果问题涉及私有 runtime 数据、token 泄漏或敏感个人信息，请不要开公开 issue。请阅读 SECURITY.md。

restart-life 是本地决策支持 harness，不构成医疗、法律、金融或心理健康建议。

开源协议

本项目基于 MIT License 开源。