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

Livepowers
活产品范式技能包

一套给智能体用的工作方法,可以直接装进 Claude Code、Codex、Cursor,或任何支持 Agent Skills 标准的客户端。它规定的流程是强制的:先走 System 1,再走 System 2;探索必须留证据;成功路径要固化;所有成果都要过独立验收。白天探索,夜间固化,早晨验收。

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

七条铁律

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

1

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

2

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

3

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

4

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

5

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

6

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

7

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

17 个技能

按工作循环分组。每个技能是一个含 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 写操作门禁

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

何时:任何写生产状态的动作。
夜间

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 只写触发条件,写完用结构测试检查。

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

一天的节律

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

时段发生什么用到的技能 / 命令
白天能复用的直接走 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 风险是否写生产状态写操作收益最大,但须过八项检查

盈亏平衡 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:.codex-plugin/plugin.json;或
cp -r livepowers/skills/* ~/.agents/skills/
cat livepowers/AGENTS.md >> your-repo/AGENTS.md
# 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/ 17 个技能(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/ 34 项测试(CI) ├── docs/ 范式一页纸 · 测试 ├── package.json AGENTS.md CHANGELOG.md LICENSE (MIT) └── README.md

与 Superpowers 的关系

借鉴了它的形式,解决的是不同的问题。

维度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 负责"固化代码怎么写好"。

落地三步

第一步

先白盒

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

第二步

再契约

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

第三步

后证据闭环

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