Skills for the Live Product paradigm · v1.4.0 · MIT

Livepowers
活产品范式技能包

业务智能体每次都从零推理,同一件事做一千次就付一千次的钱,结果还是概率性的;用 AI 更快写出的软件,业务含义仍然写死在代码里,交付即冻结。Livepowers 是一套装进 Claude Code、Codex、Cursor 的工作方法,让智能体先复用已固化的能力,没有才去探索并留下证据,把成功路径固化成经测试的代码,一切成果过独立验收——越用越熟练。

Agentic AI = Agent + Ontology + Harness
npx livepowers install   # Claude Code · Cursor · Codex
五分钟 demo其他安装方式
18 个技能4 个零依赖脚本8 个模板3 个命令SessionStart 自动注入钩子自动采集证据npx 一键安装12 个场景47 项自动化测试结构借鉴 obra/superpowers
业务请求 lp registry find HITMISS System 1 · 执行者 固化的 CLI / SQL / 工作流 CPU · 确定 · 几乎零 Token System 2 · 探索者 Agent + 大模型 GPU · 概率 · 能解新问题 证据 → 四道验收门 F-V-S-R · 盈亏平衡 n* 固化(能力包 + 注册) 失效 / 漂移 / 换模型 → 复核或去固化

为什么需要它:两种"死"

死代码

业务含义写死在程序里

交付即冻结;每次变化都要重新解释需求、改写实现。用 AI 更快地生成这种软件,只是穿新鞋走老路。

死循环的智能体

每次都从零理解、从零推理

同一件事做一千次就付一千次推理的钱,结果还是概率性的;没有证据,没有积累,产品不会变熟练。

活产品

本体定义语义,能力随使用生长

高频、可验证、稳定的事固化为 System 1(代码 / CLI / SQL,CPU,便宜、确定);新问题交给 System 2(Agent + 大模型)探索并留证据;固化失效就去固化。System 2 占比随时间下降,能力库随时间增长。

全景:它是怎么运转的

一张图看完整个系统。上面是一个请求怎么走,中间是三块地基,下面是让产品越用越熟练的日夜循环;技能名用小字标在对应位置。

① 一个请求的旅程 业务请求 "各地区上周收入?" 先翻工具箱 有没有现成的做法? 不先从零推理 system1-first 找到了 直接用现成工具 几乎不花钱 · 结果确定 · 顺手记一笔日志 没找到 先说清要什么 一次只问一个问题 ontology-grounded-spec 探索者去想办法 只在地图范围内 · 有预算上限 explore-with-evidence 质检 不能自己说了算 acceptance-gates 交付 答案 / 报表 / 动作 每一步都留下 工作日志 证据:做了什么、花了多少、 对不对。忘了记,钩子会补。 lp evidence · hooks 走不通? 到预算就止损 交出诊断 · 换人接手 takeover-handling ② 三块地基 业务地图(本体) 业务里有哪些东西、什么状态、口径怎么算、 谁能做什么。写在代码外面,可以确认和改版。 智能体只在地图范围内行动;地图缺了就先补地图 env-scan-ontology · ontology-evolution 工具箱(已固化的能力) 反复做成功的事,做成"按钮":代码、命令、 查询、流程。每个都带测试、版本和责任人。 按得越多越便宜;不灵了就下架,回到探索 crystallize-to-system1 · agent-harness 操作手册(18 个技能) 什么时候该做什么、怎么做、做到什么程度算完。 会话一开始就自动翻开,是规定不是建议。 装进 Claude Code / Cursor / Codex 即可 using-livepowers 路由到其余 17 个 ③ 一天的节律:产品越用越熟练 白天 · 用和探索 能用工具的用工具;没有的让探索者做, 每一步留日志。写操作先演练再执行。 多个智能体协作时,对话经过可审计的交换机 oltp-action-safety · auditable-agent-comms 夜里 · 整理和固化 翻一天的日志:哪件事反复成功、值得做成 按钮?先算值不值,再写测试和草稿。 顺便检查旧工具还灵不灵、环境有没有变、模型有没有退步 nightly-crystallization-review · night-loop-planning 早晨 · 人来验收 看晨报,逐个决定:通过的放进工具箱, 不通过的写明原因。做的人不能自己验收。 夜里永远只出"草稿 + 测试证据",决定权在人 acceptance-gates · /lp-morning 通过验收的新工具,放进工具箱 → 明天的请求更多走"找到了" 四道护栏,贯穿全程 质检:回执为准,不认自我声明 acceptance-gates 写操作:先演练,八项检查 oltp-action-safety 账本:先有基线,再谈价值 outcome-ledger 交付到现场:资产回流,越做越快 fde-delivery
读图 ①

先翻工具箱,再派人探索

任何请求先看有没有现成的做法:有就直接用,几乎不花钱、结果确定;没有才让"探索者"(智能体 + 大模型)去想办法——先说清要什么,只在业务地图范围内摸索,做完要过质检。每一步都留下工作日志;走不通就到预算止损,换人接手,而不是无限重试。

system1-first · ontology-grounded-spec · explore-with-evidence · acceptance-gates · takeover-handling
读图 ②

三块地基各管一件事

业务地图回答"业务里有什么、怎么算、谁能做",写在代码外面,可以确认和改版;工具箱装的是反复成功后做成"按钮"的能力,每个带测试和责任人;操作手册是 18 个技能,规定什么时候做什么,会话一开始就自动翻开。

env-scan-ontology · ontology-evolution · crystallize-to-system1 · agent-harness-for-tools · using-livepowers
读图 ③

白天用,夜里整理,早晨验收

白天探索留日志;夜里翻日志,把反复成功的做法先算值不值、再写测试和草稿,顺便查旧工具还灵不灵;早晨人看晨报逐个决定,通过的放进工具箱。于是明天的请求更多走"找到了"——这就是"越用越熟练"。四道护栏贯穿全程:质检、写操作安全、账本、现场交付的资产回流。

nightly-crystallization-review · night-loop-planning · outcome-ledger · fde-delivery

七条铁律

写在 using-livepowers 里,会话启动时由钩子注入。它们是强制流程,不是建议。

1

先检查技能。只要有 1% 的可能适用,就先读。

2

先 System 1,后 System 2。命中已固化的能力就直接执行,不再重新推理。

3

没有证据的探索等于没发生。每次探索后都要运行 lp evidence add。

4

不在本体之外操作。缺对象或口径时提本体变更,不要用一段脚本把缺口盖过去。

5

写操作必须过安全门禁。八项检查:状态前提、权限、事务、幂等、并发、审批、审计、补偿。

6

生成者不评审自己。以真实回执为准,不认 Agent 的自我声明。

7

没有基线的价值不算价值。承诺业务结果之前,先登记基线。

18 个技能

按工作循环分组。每个技能是一个含 SKILL.md 的文件夹,符合 Agent Skills 开放标准。标 NEW 的是 v1.0 新增的。

入口

using-livepowers 总入口

七条铁律、路由表、三层架构落点(本体 / 工具 / 技能)、标准工作循环和反模式。

何时:每个会话开始时(自动注入)。
本体

env-scan-ontology 环境感知

两种起步:存量改造(先扫描摸清现有系统)和新建再造(从预置本体出发)。只读扫描,生成环境指纹和本体草稿,夜间检测漂移。

何时:接入新系统、进现场、怀疑环境变了。
本体

ontology-grounded-spec 规格编译

一次只问一个问题;先判断变化落在哪一层(界面 / 参数 / 功能 / 本体 / 会话);用户不确定的说法记为假设;写出带业务不变量和验收样例的规格。

何时:实现任何业务功能之前。
本体 · NEW

ontology-evolution 本体演进

四个状态:候选 → 已校验 → 已确认 → 已发布。每次变更写明来源、适用范围、生效时间,以及历史结果要不要重算。大小调整走两条通道。

何时:缺对象、口径冲突、规则变更。
System 1

system1-first 优先路由

先把请求规范成意图,再查注册表:命中就执行,未命中才进入探索。同时定义了四种去固化信号。

何时:收到任何业务请求时。
System 2

explore-with-evidence 探索留证据

先定轮次和预算,超限自动止损。探索只在本体范围内进行,写操作只预演,结果要用样例核对,并留下别人能接手的产物和证据。

何时:注册表未命中时。
固化

crystallize-to-system1 Coding Harness

F-V-S-R 门禁和盈亏平衡 → 先写测试 → 确定性实现 → 组装能力包 → 独立验收 → 注册。新能力在产品内上线,不必整版升级。

何时:同一路径反复探索成功时。
System 1

agent-harness-for-tools Agent Harness

每个工具一张工具卡、带决策点的业务剧本、硬约束;弱模型跑 10 次成功率要 ≥95%。换模型就重跑基准,模型升级后不再需要的约束就去掉。

何时:接口已有但 Agent 用不稳,或要换模型时。
验收 · NEW

acceptance-gates 四道门禁

四道门依次是:形式检查、契约测试、独立对抗审查、人工采纳。以回执为准,不认声明;派工、执行、验证、采纳、运营五种职责分开。

何时:任何成果要进生产或要说"完成"时。
安全

oltp-action-safety 写操作门禁

先仿真后执行;八项检查各配对应测试;审批后重新校验;超时先查状态再决定是否重试;写清存量系统能保证到什么程度。

何时:任何写生产状态的动作。
接管 · NEW

takeover-handling 异常接管

止损后先冻结、交付诊断包;七类主因只选一个(规格不清 / 本体缺口 / 环境漂移 / 能力失效 / 预算太低 / 工具故障 / 不该做);换人重开、重定规格或关闭,接管成本入账。

何时:任务被止损、Agent 反复失败、人要接手时。
夜间

night-loop-planning 长程任务

强模型规划、便宜模型执行;按模型能稳定运行的时长切段;交接时写实际终态并指定独立检查者;用 DAG 拆任务、设止损和熔断,统一填作业契约。

何时:跨小时或跨夜的任务。
夜间

nightly-crystallization-review 固化评审

看 System 2 占比的变化趋势,挑出固化候选,复核已有能力(失败、闲置、久未复验、换了模型),跑金丝雀评测,生成晨报。

何时:收工或夜间作业开始时。
协作

auditable-agent-comms 可审计协作

按信任域分级;协调消息和大块内容分两条线;所有 Agent 共用一个任务标识和契约版本;哈希链防篡改,支持回放和审计。

何时:多个 Agent 互相通信时。
交付

fde-delivery 现场交付

五类底座资产;先白盒、再契约、后证据闭环;同时选一个降本场景和一个增收场景;现场成果过四道门进资产库,并统计回流率;FDE 考核看两项指标。

何时:把领域产品交付到客户现场时。
价值 · NEW

outcome-ledger 结果台账

价值闸门:可量化、可归因、可复现、可经营。先登记基线,再算单位验收任务成本(失败的成本也计入)、首次价值交付时间,以及增量价值 ΔV = B × u。

何时:承诺结果、论证价值、讨论计价时。
价值 · NEW

digital-role-spec 数字岗位

岗位 = 角色 + 职责 + 智能体团队 + 本体 + 技能 + 工具 + 权限 + KPI + 升级路径 + 人在回路。每项任务标明归属,并算清岗位的经济账。

何时:把一个岗位交给"人 + 智能体团队"时。
元 · NEW

writing-livepowers-skills 编写技能

先看 Agent 在没有技能时如何失败,再写最小的技能去纠正它。description 只写触发条件,写完用结构测试检查。

何时:新建或修改技能时。

12 个场景

每个场景写清触发 → 走哪些技能 → 产出。完整命令见 docs/scenarios.md。

1 · 首响

周报类查询第一次来

注册表未命中,会话级小请求不建任务,直接在本体范围内探索,用已知数字核对,留证据。

system1-first → explore-with-evidence
2 · 固化

同一件事第三次探索成功

评分 ≥5 且调用次数 > n*:夜间先写测试再写参数化 SQL,登记产物;早晨人工过四道门后注册。

nightly-crystallization-review → crystallize-to-system1 → acceptance-gates
3 · 命中

请求命中已固化能力

lp registry find HIT,核对前置条件后按 entry 调用,几乎零 Token;证据里 S1 占比上升。

system1-first
4 · 写操作

把逾期的重点商机转给主管

"有效跟进"是本体层变化;原子行动填八项检查与九项测试;先预演后执行;注册必须带测试。

ontology-grounded-spec → ontology-evolution → oltp-action-safety → acceptance-gates
5 · 接入

接入一个用了八年的存量 CRM

只读扫描生成环境指纹和本体草稿,业务逐个确认对象、状态机、口径;选试点场景,登记基线。

env-scan-ontology → fde-delivery → outcome-ledger
6 · 漂移

夜里发现状态机多了一个取值

指纹比对报漂移;相关能力退役回到 System 2;提本体 Delta 后用 --supersedes 固化新版本。

env-scan-ontology → ontology-evolution → system1-first(去固化)
7 · 接管

探索三轮没收敛

脚本止损;执行者冻结并交付诊断包;接管人归因只选一个主因;换人重开或重定规格;接管成本入账。

takeover-handling → outcome-ledger
8 · 换模型

换了更便宜的执行模型

金丝雀记录与比较;Skill 类能力标记待复验;重跑基准后去掉不再需要的约束。

agent-harness-for-tools → nightly-crystallization-review
9 · 协作

派工、执行、评审三个 Agent

同一任务 id + 契约版本;消息经交换机,哈希链防篡改;审计点名"声称完成却无回执"。

auditable-agent-comms → acceptance-gates
10 · 岗位

合同审核岗交给人 + 智能体团队

任务归属 auto / agent / handoff / human;接管条件与 KPI;接管比例高就先固化再谈规模。

digital-role-spec → outcome-ledger
11 · 跨夜

夜里把 500 份合同抽成结构化字段

强模型拆 DAG,按便宜模型可稳定运行的时长切段;每段写作业契约、独立检查者与止损。

night-loop-planning
12 · 计价

向客户说明到底省了什么

基线 → 测量 → 成本归集(含失败、返工、接管)→ 验收任务平均成本、首次价值交付时间、ΔV。

outcome-ledger

五分钟 demo

bash examples/walkthrough.sh 的真实输出:用一个虚构的商机数据库走完 扫描 → 基线 → MISS → 三轮探索 → 评分 → 看板 → 独立验收 → 注册 → HIT → 台账 → 漂移 → 晨报。

工作目录:<临时目录>
已初始化 .livepowers/(evidence.jsonl, registry.json, tasks.json, outcomes.jsonl, assets.json, reports/)
--- 本体草稿(节选)
# 本体草稿(scan_sqlite.py 自动生成)——须业务确认后才能晋升为 ontology.yaml
source: sqlite:demo.sqlite
ontology_version: 0.1.0-draft
objects:
  - name: activities
    description: ""   # TODO(需业务确认) 业务含义
    identity: ['id']
    row_count: 0
    attributes:
      - {name: id, type: INTEGER, nullable: true}
      - {name: opportunity_id, type: INTEGER, nullable: true}
      - {name: kind, type: TEXT, nullable: true}
      - {name: created_at, type: TEXT, nullable: true}  # 候选时间字段:事件时间还是快照时间?
已登记基线 stale-opps/逾期重点商机数 = 40.0
MISS —— 未命中已固化能力 → 转 System 2 探索(记得记录证据)
(MISS → System 2)
t_8a03132e: 待澄清 → 规格确认
t_8a03132e: 规格确认 → 探索
t_8a03132e: 探索 → 探索
t_8a03132e: 探索 → 探索
固化候选(按 调用次数 × 可验证度 排序):
- transfer stale opportunity: S2 3 次, 成功率 100%, 可验证 100%, 均成本 0.8000 (写操作:需 oltp-action-safety)
F-V-S-R 评分: 10.0/10  分项 {'F': 2, 'V': 2, 'S': 2, 'R': 1}
System 2 有效单次成本 c2' = 2.2500(含失败重试与人工兜底)
盈亏平衡调用次数 n* = 11.1;预计 6 个月内调用 180 次
建议: 固化
提示: 写操作——固化前必须完成 oltp-action-safety 八项检查测试
t_8a03132e: 探索 → 待验证
t_8a03132e: 待验证 → 已注册
已注册 cap_转交逾期商机 v1.0.0
HIT —— 命中已固化能力 → 走 System 1 执行:
  [3] cap_转交逾期商机 v1.0.0 (cli) entry: crm opp transfer-stale --days {days}  [写操作]
ok
ok
### 场景 stale-opps
- 逾期重点商机数: 基线 40.0 → 目标 10.0;当前 22.0(Δ -18,-45.0%)
- 归集成本 2.40(inference 2.40)
- 通过验收任务 1,未通过 0;验收任务平均成本 = 2.40
- 首次价值交付时间:0.0 天(自范围确认至首个生产任务被采纳)
环境漂移:
- customers: 新增列 industry
- opportunities.stage: 状态出现新取值 ['on_hold'](状态机须更新)
--- 晨报:.livepowers/reports/morning-2026-10-07.md
# 晨间报告 · 2026-10-07
…(晨报:待验收产物 · 固化候选 · 金丝雀 · 能力复核 · 看板 · 台账 · 需要人决定的事)

一天的节律

技能之间如何衔接:白天探索,夜间固化,早晨验收。

时段发生什么用到的技能 / 命令
白天能复用的直接走 System 1。不能复用的先建任务、设好轮次和预算,再由 Agent 探索;结果经样例核对、过验收门后交付,并留下证据。写操作先预演,确认后再执行。system1-first · explore-with-evidence · acceptance-gates · oltp-action-safety
lp registry find · lp task · lp evidence add
傍晚把长程任务拆成 DAG,按模型能稳定运行的时长切段,填好作业契约和交接契约,设止损条件。night-loop-planning · lp job validate
夜间长程任务运行。固化评审生成草稿和测试;扫描环境漂移;复核已有能力;跑金丝雀评测。Agent 间的协作全程经交换机记录。nightly-crystallization-review · crystallize-to-system1 · env-scan-ontology · auditable-agent-comms
lp candidates · lp score · lp registry review
早晨读晨报。人工采纳后注册(生成者和采纳人必须不同),不通过的写明原因。处理复核项和转入异常接管的任务,更新结果台账。/lp-morning · lp report · lp registry add / retire / verify · lp outcome

任务看板:每次迁移都有条件和责任主体

lp task 把看板规则写成了代码,不只是写在文档里。

待澄清 规格确认 探索 待验证 已注册 生产运行 超出轮次 / 预算 → 自动转「异常接管」 须有证据,且操作人不能是执行者 去固化:回到探索

固化门禁:F-V-S-R 与盈亏平衡

不是所有探索都值得固化。lp score 同时给出评分和盈亏平衡调用次数 n*;建议固化时退出码为 0,否则为 3。

维度含义取值
F 频率每月预计调用次数<4 → 0;4–19 → 1;≥20 → 2
V 可验证结果能否被样例 / 断言自动核对0 / 1 / 2;V=0 一票否决
S 稳定口径、输入结构、接口是否稳定0 / 1 / 2
R 风险是否写生产状态写操作收益最大,但须过八项检查
合成分 = F×2 + V×1.5 + S + R(满分 10);≥5 且预计调用次数 > n* 才建议固化

盈亏平衡 n*

n* = (K + M) / (c2′ − c1)
c2′ = c2 / p + (1 − p)·h / p

K 是固化成本,M 是维护成本,c1 / c2 是单次执行成本,p 是 System 2 的成功率,h 是失败后人工兜底的成本。成功率越低,固化越划算。夜间空闲算力可以摊薄 K;口径常变会抬高 M。

四道验收门 · 结果台账

v1.0 把"算不算完成"和"值不值"也变成了可检查的流程。

门发现什么由谁
1 形式检查结构、类型、必填字段、本体版本机器
2 契约测试验收样例、业务不变量、八项检查机器
3 独立对抗审查遗漏的前提、口径偏差、越权和异常路径与生成者分离的审查者,用保留测试集
4 人工采纳业务意义、未被覆盖的风险有权的业务责任人
台账指标定义
验收任务平均成本全部归集成本(含失败、返工、接管)÷ 通过验收的任务数
首次价值交付时间从范围确认到首个生产任务被采纳
增量价值ΔV = 业务基数 B × 提升率 u
资产回流率进入参考库的现场成果 ÷ 现场成果总数

自带脚本

纯 Python 3.9+ 标准库,不用安装任何依赖。数据全部落在项目的 .livepowers/ 下,建议纳入 git。

lp init
lp registry find "帮我看一下各地区的周收入"      # HIT → exit 0;MISS → exit 2
lp task new --title "逾期商机移交" --max-loops 5 --budget 20
lp task move t_xxx explore --by agent-a --reason "假设:按最近有效跟进计" --cost 0.8
lp evidence add --intent "transfer stale opportunity" --system S2 --outcome success --cost 0.8 --verifiable --task t_xxx
lp score --freq 30 --verifiable 2 --stability 2 --writes-state --c2 0.8 --c1 0.001 --K 20 --M 5 --p 0.8 --h 5
#  → F-V-S-R 10.0/10;c2' = 2.25;n* = 11.1;6 个月预计 180 次 → 建议: 固化
lp task move t_xxx registered --by reviewer-b --reason "四道门通过" --evidence acceptance.md
lp registry add --name "转交逾期商机" --kind cli --intents "transfer stale opportunity,转交逾期商机" \
   --entry "crm opp transfer-stale" --writes-state --tests "pytest tests/" --generated-by agent-a --accepted-by reviewer-b
lp outcome baseline --scenario stale-opps --metric "逾期商机数" --value 40 --target 10
lp asset gate as_xxx abstractable --by reviewer      # 依次 versioned / evaluated / reusable
lp registry review --current-model model-b           # 连续失败 / 闲置 / 久未复验 / 换模型
lp report                                             # .livepowers/reports/morning-日期.md
# 中转模式:所有 Agent 间消息经交换机,append-only + 哈希链
python agent_switch.py serve --port 7070 --log .livepowers/comms.jsonl
python agent_switch.py send --from supervisor --to executor --type task --body "实现 issue #12" \
   --trace t1 --task t_9f2c --contract spec-12@1.1
# 旁路模式:不中转,框架插件在收发时落盘;大块内容只传引用
python agent_switch.py sidecar-log --from executor --to reviewer --type result --body "完成" --ref git:feat/x@a1b2
python agent_switch.py replay --trace t1 --speed 1
python agent_switch.py verify      # 日志被改动会报"哈希链断裂"
python agent_switch.py audit       # 被拒消息 / 未闭合 trace / 声称完成却无回执
# 只读扫描 → 本体草稿 + 环境指纹(敏感字段只记名称,不抽样)
python scan_sqlite.py crm.sqlite --fingerprint fp-1.json > .livepowers/ontology.draft.yaml
#  relations:
#    - {from: opportunities.customer_id, to: customers.id, evidence: foreign_key}
#    - {from: opportunities.owner_id,    to: owners.id,    evidence: name_inferred}  # 推断,须确认
# 夜间漂移检测
python scan_sqlite.py --diff fp-1.json fp-2.json     # 有漂移 exit 5
#  - customers: 新增列 industry
#  - opportunities.stage: 状态出现新取值 ['on_hold'](状态机须更新)

安装

# 一键安装技能(默认装到 ~/.claude/skills)
npx livepowers install
# 其他客户端:--target codex | cursor | agents
npx livepowers install --target cursor
# 装到当前项目;codex 会同时合并 AGENTS.md 入口说明
npx livepowers install --target codex --project
# 全局安装后可直接用 lp 命令(需要 Python 3.9+)
npm i -g livepowers && lp --version
# 查看 / 卸载
livepowers list
livepowers uninstall --target codex --project
/plugin marketplace add zhanglunet/livepowers
/plugin install livepowers@livepowers-marketplace
# 自带 SessionStart 钩子,自动注入 using-livepowers
# 命令:/lp-route  /lp-nightly  /lp-morning
git clone https://github.com/zhanglunet/livepowers
# 个人
cp -r livepowers/skills/* ~/.claude/skills/
# 团队共享(随仓库走)
cp -r livepowers/skills/* your-repo/.claude/skills/
# Codex:装到项目,并把入口说明合并进项目的 AGENTS.md(带标记,可卸载)
npx livepowers install --target codex --project
# 或作为插件:.codex-plugin/plugin.json
# Cursor:个人技能目录 ~/.cursor/skills
npx livepowers install --target cursor
# 或作为插件:.cursor-plugin/plugin.json + hooks/hooks-cursor.json
# 每个技能单独打包为 zip,在设置的技能页逐个上传
bash livepowers/scripts/package-skills.sh
ls livepowers/dist/skills/
livepowers/ ├── .claude-plugin/ .codex-plugin/ .cursor-plugin/ ├── bin/ npm:livepowers 安装器 · lp 命令 ├── hooks/ SessionStart 注入 · 证据自动采集 ├── commands/ /lp-route · /lp-nightly · /lp-morning ├── skills/ 18 个技能(SKILL.md) ├── scripts/ │ ├── lp.py 证据 · 路由 · 评分 · 看板 · 台账 · 资产 · 晨报 │ ├── agent_switch.py 交换机 · 回放 · 校验 · 审计 │ ├── scan_sqlite.py 扫描 · 指纹 · 漂移 │ └── package-skills.sh 打包 ├── templates/ ontology · ontology-delta · action · spec │ tool-card · capability-package │ digital-role · job-contract ├── examples/walkthrough.sh 五分钟完整体验 ├── tests/ 47 项测试(CI) ├── docs/ 范式 · 场景 · 对比 · 开发日志 · 测试 · 本站 ├── package.json AGENTS.md CHANGELOG.md LICENSE (MIT) └── README.md

对比:Superpowers 与同类产品

借鉴了 Superpowers 的形式,解决的是不同的问题;两者可以同装。逐项对比、三种串联用法和 9 个同类产品的详细表见 docs/comparison.md。

维度obra/superpowersLivepowers
定位软件开发方法论:让编码 Agent 像资深工程师一样工作企业业务产品范式:让业务 Agent 在本体内工作,并越用越熟练
主流程brainstorming → worktree → writing-plans → 子 Agent 执行 → TDD → reviewsystem1-first → 探索留证据 → 验收门 → 夜间固化评审 → TDD 固化 → 能力包注册 → 复核 / 去固化
世界模型代码仓库本体(描述面 + 运行面),带环境感知、漂移检测和版本化演进
固化物人工从对话中提炼的 markdown 技能带测试、版本和元数据的确定性代码 / CLI / SQL,组装成能力包;生成者 ≠ 采纳人由脚本强制
异常与夜间遇阻即停,交给人止损 → 异常接管技能;夜间固化评审、金丝雀、晨报、早晨人工采纳
成本与价值未涉及F-V-S-R、盈亏平衡 n*、S2 占比趋势、结果台账、资产回流率
写操作安全通用 code review先仿真后执行;八项检查与对应测试
多 Agent子 Agent 执行,逐任务审查派工 / 执行 / 验证 / 采纳 / 运营五种职责分离;可审计交换机、回放、信任域分级
共同点技能是强制工作流;会话启动时注入入口技能;TDD;生成与评审分离;澄清时一次只问一个问题;用压力测试来写技能。两者可以同时安装:Livepowers 负责"做什么、要不要固化、算不算完成",Superpowers 负责"固化代码怎么写好"。

和其他同类产品比,Livepowers 最像谁、独有什么:

产品定位最像的点Livepowers 独有 / 缺失
Agent Skills 标准 · anthropics/skills开放技能格式与官方示例库Livepowers 完全遵循该格式独有整套业务方法论与运行时;缺触发率自动评测
GitHub spec-kit规格驱动开发constitution ≈ 铁律 + 不变量;converge ≈ 验收门独有 System 1 路由、固化经济学、夜间循环;缺任务 ID 产物链
BMAD-METHOD角色化 Agile 框架多角色 ≈ 数字岗位 + 职责分离独有本体、固化、台账;缺 PRD / Story 模板体系
Agent OS提取代码规范注入 Agent从环境提取标准 ≈ 环境扫描扫的是业务语义而非代码风格
claude-flow / Ruflo多 Agent 编排平台从成功轨迹学习 + 路由 ≈ System 1 优先固化物是可测试代码,有人工采纳门;缺向量检索
Palantir AIP / Ontology商业企业平台Agent + Ontology 公式;行动审批审计开源、零依赖、可装进任意 Agent;缺本体运行时
Devin Playbooks可复用流程 promptPlaybook ≈ 工具卡 + 剧本固化物是代码而非 prompt;缺从会话自动生成
Voyager 式自增长技能库自动蒸馏技能探索留证据 → 固化独有 n*、生成者 ≠ 采纳人、去固化;缺 hook 自动采集
skills.sh · Cursor rules分发渠道npx 安装对应这些渠道未上架 skills.sh;不生成 .mdc

FAQ

和 Superpowers 能同时装吗?会打架吗?

能,而且建议同装。Livepowers 决定"做什么、要不要固化、算不算完成",Superpowers 决定"固化代码怎么写好"。两者的入口技能都在会话启动时注入,互不覆盖;固化流水线里 Livepowers 挑候选并验收,Superpowers 的 brainstorming → writing-plans → TDD 负责实现。

不用 Claude Code 能用吗?

能。npx livepowers install --target cursor | codex | agents 装到对应客户端的技能目录;任何支持 Agent Skills 标准的客户端都能读 skills/*/SKILL.md。区别是只有 Claude Code 插件自带 SessionStart 钩子自动注入入口技能,其他客户端靠技能描述触发,Codex 可以把入口说明合并进项目的 AGENTS.md(安装器会做)。

lp 命令在哪里?

npm i -g livepowers 后直接用(需要 Python 3.9+);Claude Code 插件里是 python3 ${CLAUDE_PLUGIN_ROOT}/scripts/lp.py,钩子会告诉 Agent 路径;仅复制技能的用户给仓库脚本起个别名。lp --help 列出全部子命令。

数据存在哪?要不要进 git?

全部在项目的 .livepowers/ 下(证据、注册表、看板、台账、金丝雀、晨报、夜间产物),建议纳入 git——它就是产品"变熟练"的记录。本仓库自己的 .gitignore 忽略它只是因为仓库不是业务项目,不要照抄。

必须先有本体才能开始吗?

不必。用 env-scan-ontology 扫出的草稿本体(版本 0.1.0-draft)就能走通第一个任务,规格里引用草稿对象名,等业务确认后升版。但铁律 4 不变:缺对象、缺口径时提本体变更,不要用脚本掩盖。

Agent 会不会"自己说完成"就算完成?

不会,这正是它要解决的问题。完成与否由验收条件决定:看板拒绝执行者把任务迁到已注册,注册要求生成者 ≠ 采纳人,夜间产物清单拒绝自我验收,交换机审计会点名"声称完成却无回执"的消息。

Agent 忘了记证据怎么办?

Claude Code 插件自带 PostToolUse / Stop 钩子:lp registry find 命中后每次调用该能力都自动记一条 S1 证据(失败也记,能力置信度随之升降);未命中而本轮结束前没有 lp evidence add,钩子补记一条 partial 的 S2 证据,晨报单列"自动采集待确认"。显式记录仍然优先——它有可验证标记、成本和说明;自动记录只是兜底,LP_HOOK_CAPTURE=0 可关闭。

固化会不会把错误也固化进去?

可验证度 V=0 一票否决;候选要 3 次成功且被样例核对过;固化物必须带测试;写操作缺测试拒绝注册;早晨由人采纳;运行期连续失败、口径变化、环境漂移、换模型都会触发复核或去固化。自动固化并不可靠,所以夜间产出的永远是"草稿 + 测试证据",最终决定权在人。

同一件事换个说法,会不会被当成新需求重复探索?

用同义词表解决:lp intents alias "weekly revenue by region" "各地区周收入" 登记后,这个别名记的证据自动归到规范名,lp registry find 也按整组同义词匹配。夜间 lp intents suggest 会列出"长得像"的意图对让人确认——只建议,不自动合并,合错口径比多探索一次代价高。

只有 SQLite 扫描脚本,我的库是 PostgreSQL / MySQL 怎么办?

scan_sqlite.py 是示例:按同样的输出结构(对象、属性、外键、状态取值抽样、指纹)查你数据库的 information_schema 即可,其余流程不变。欢迎提 PR 补其他数据库的扫描器。

落地三步

第一步

先白盒

选一个有代表性的分析场景,启用 using-livepowers、system1-first、explore-with-evidence、outcome-ledger。先登记基线、记录证据,统一意图的命名。

第二步

再契约

把关键口径写进本体和规格。开启 acceptance-gates 和夜间评审,每天早晨人工采纳,观察 System 2 占比的曲线。

第三步

后证据闭环

扩展到写操作场景和长程任务,多 Agent 协作接入交换机。现场交付统一走 fde-delivery,把资产回流率纳入评价。

开发日志

做了什么、为什么、放弃了什么。全文见 docs/devlog.md;版本条目见 CHANGELOG。

反馈与参与

这个项目靠使用反馈迭代。用了之后哪里别扭、不清楚、Agent 绕过了规则、想要什么场景,都请告诉我们。

反馈

使用反馈 / 问题

哪里不清楚、期望什么、用在了什么场景。写下你读到哪一句开始不明白,最有帮助。

Bug

问题报告

技能没触发、脚本出错、Agent 绕过了某条规则。附 lp 输出或对话片段(脱敏)。

提议

技能提议

先写下没有这个技能时 Agent 在什么压力情境下怎么失败——这是写技能的第一步。

想动手?路线图总览里每一项都是可独立领取的小项目(触发率评测、任务 ID、Cursor 规则、skills.sh、语义检索、数据库扫描器……)。场景交流与落地经验请到 Discussions。提 PR 前先读 writing-livepowers-skills,并运行 python -m unittest discover -s tests -v。