value-audit

在继续烧 token 之前，先回答：这个项目凭什么收钱？

别人验证的是你嘴里的 idea，本工具审计的是你仓库里的代码。 确定性画像采集、结论落到具体文件路径、改进建议按 git diff 跨审计核销——它审的是你项目的 真实状态，不是你对项目的描述；且全程在你本地运行，代码与商业事实不上传任何服务器 （可选的匿名使用统计默认关闭，字段白名单见下文"隐私与匿名统计"）。

value-audit 是一个 pi 扩展。在任意项目目录执行 /value-audit， 它会采集项目画像、对照内置的价值审计方法论，产出一份《价值审计与路演准备报告》：

• 🚦 审计结论（红/黄/绿灯）——包括敢于告诉你"这个方向别做了"的红灯机制
• 🧭 核心逻辑提炼——从代码而非 README 提炼"为谁把什么变成什么、钱在哪一步"
• 💰 商业建议——付费方、定价逻辑、差异化、风险，以及"持久盈利运转模型"（收入/留存/成本/渠道/壁垒五环， 结合联网检索的同类盈利模式基准，指出最弱一环）
• 👀 用户观测就绪检查——确定性检测项目有没有手段看到"用户用了哪些模块"（内置埋点或 GA4/百度统计/Umami/PostHog 等）；没有就按技术栈与用户地域给出一天能接完的最小事件集与工具建议
• 🔧 行动 backlog——验证动作优先于代码改动（先花最小成本验证前提，再谈怎么改），带稳定 ID，可跨审计核销
• 🎤 投资人问答稿——默认精简版（只答有证据的题 + 缺口清单）；明示在融资/路演时输出 32 题全稿

适用时机（越具体越有效）：准备融资/路演前、项目做了几个月还没人付费时、决定要不要继续投入时。 不限技术栈与项目类型，但它对"要回答收钱问题"的项目才有价值——纯公益/纯学习项目不需要它。

完全免费。

五条产品原则

1. 零打扰：全程不问问题（唯一例外：代码无变化时确认是否重跑）。能从代码、README、git 历史推断的信息自动推断；推断不了的落到报告缺口清单，事实档案填不填由你决定，不填也能出报告。
2. 诚实优先：每个结论标注来源——[代码证实]（附文件路径）/ [用户提供]（来自你填写的事实档案）/ [联网检索]（附来源 URL 与日期，只采信权威来源）/ [待验证]（只给回答框架和验证动作，绝不编造数字）。
3. 敢亮红灯：如果审计发现"用户本来就不做这件事"或"停用后没人痛"，报告不会生成粉饰性的 路演答案，而是直接给出转向建议。一个只会夸你的审计工具不值得存在。
4. 迭代闭环：审计 → 按 backlog 改代码 → 复审。复审基于 git diff 核销 backlog、对比灯色变化， 而不是失忆重来。
5. 不借焦虑运营：驱动你复审的只有真实的进度（backlog 核销、距下一灯色的真实缺口）与 真实的停用损失（你积累的审计档案）。本工具永不做连续打卡、倒计时施压、FOMO 通知、 羞辱式对比——审计工具靠说真话留住你，不靠焦虑绑架你。

安装

pi install git:github.com/doccker/value-audit

试用（不安装）：

pi -e git:github.com/doccker/value-audit

使用

/value-audit             # 执行审计（首次生成事实档案模板；完成后自动打开档案目录）
                         # 意图为商业化且档案里还没有市场资料时，会先自动跑一次 market 再审计（facts 第 0 节写自用/开源则跳过；
                         # 意图未填时先问一次是否联网）
/value-audit focus 定价  # 聚焦某个主题的审计（定价/壁垒/渠道…）
/value-audit note <文本> # 记录决策/现实反馈到决策日志，下次审计作为证据，复审时对照"预测→实际"
/value-audit todo        # 查看未核销的改动建议（按优先级）
/value-audit do B3       # 把某条 backlog 交给当前 agent 执行（验证类出访谈脚本/取数步骤，代码类做最小改动）
/value-audit market [url…] # 联网竞品调研：固定 14 列竞品表（按热度降序，多次执行按 URL 合并累积）+ 价格锚点 + 结合你处境的改造建议
/value-audit list        # 所有项目的灯色汇总（多项目/机构场景）
/value-audit where       # 查看档案路径
/value-audit open        # 打开档案目录
/value-audit export [目录] # 导出报告（默认到当前目录，显式动作不算污染）

本地开发/多项目试用：pi install /本地/仓库/路径（路径安装不复制文件，改完代码 /reload 生效）。

两种安装方式只能保留一种。同时安装会在启动时报 Tool "value_audit_save" conflicts with ...，此时执行 pi remove git:github.com/doccker/value-audit 或 pi remove /本地/仓库/路径 去掉其中一个即可（也可直接编辑 ~/.pi/agent/settings.json 的 packages 数组）。

典型工作流：

1. 首次执行 /value-audit，得到报告 + 事实档案模板 facts.md
2. 填写 facts.md（用户数、团队、定价等代码里看不出的事实）
3. 重跑 /value-audit，问答稿标记升级
4. /value-audit do <ID> 逐条推进 backlog，提交后再跑，报告自动生成"变化对比"节，核销已完成项

产物位置

所有产物存放在你的用户目录下，不污染项目代码：

~/.value-audit/projects/<项目名>-<hash>/     # Windows: %USERPROFILE%\.value-audit\...
├── VALUE-AUDIT.md    # 最新报告
├── NEXT.md           # 一页纸：本周唯一动作 / 卡在哪 / 什么信号重跑（每次审计覆盖）
├── facts.md          # 你的商业事实档案（只增不改）
├── facts-draft.md    # 报告附录的填写参考草稿（生成物；核实后复制进 facts.md，工具不代写）
├── journal.md        # 决策日志（/value-audit note 追加）
├── market.md         # 竞品调研与改造建议（market 生成；主审计引用，90 天后提示刷新；旧版快照进 history/market-*.md）
├── market.json       # 竞品结构化数据（按 URL 累积合并，market.md 由它渲染）
├── state.json        # 审计状态（backlog 核销、历次结论）
└── history/          # 每次审计的报告快照

⚠️ 该目录不在任何版本控制中。facts、决策日志与历次快照里有不可重建的判断记录，建议定期备份 （如 rsync -a ~/.value-audit/ <私有仓库或网盘路径>/，或把目录软链进你的私有 dotfiles 仓库）。

项目身份：git 仓库按根提交识别（移动目录不丢档案）；非 git 项目按绝对路径识别（移动 = 新档案）。

自定义知识层：在 ~/.value-audit/knowledge/ 放你自己的 .md（行业基准、补充题库），审计时自动追加在内置知识库之后。

方法论来源

内置知识库蒸馏自三份材料（见 knowledge/）：

• 价值审计七问：用户为"少承担麻烦"付费、寻找"靠人硬撑的流程"、停用损失决定付费意愿
• PMF 生存检查表：价值主张、差异化、商业模式、渠道、合规、成本结构等 12 维度
• 投资人提问地图：问题 / 人 / 解 / 钱 四组 32 题

已知边界

• 分析质量取决于你在 pi 中使用的模型；本工具负责框架、证据采集和输出结构，不负责判断力本身
• 联网检索不引入任何搜索 API key：启动时确定性检测本机 gh CLI 与 playwright（含其他 nvm 版本目录、 @playwright/mcp 的 npx 缓存），随扩展附带的 fetch-page.mjs 只做只读 GET（无 playwright 时退回纯 HTTP， JS 渲染页可能只有壳）；不调用搜索引擎，新竞品靠已知页面/README 的链接发现；检索失败退回 [待验证]
• market 一次最多 25 次抓取；主审计仍限 8 次并优先复用未过期的 market.md。竞品表的排序、历史行合并由代码完成 （同一 URL 多次调研只更新非空字段，未复核的旧行保留并标注数据日期），模型只负责核实与填写
• 大型仓库的画像采集做了截断，细节由 agent 按需读取

隐私与匿名统计

• 审计全程在本地运行，代码、报告、商业事实永不上传。
• 匿名使用统计默认关闭：首次审计完成后询问一次，/value-audit stats on|off 随时更改。
• 开启后只上报：匿名随机 ID、工具版本、事件名（审计开始/审计完成/保存失败/子命令使用）、 审计序号、灯色、子命令名（固定枚举，如 todo/list）、错误类别（固定枚举）、操作系统平台。
• 绝不上报：项目名/路径、代码、报告/facts/journal 内容。
• 上报失败静默忽略，不影响任何功能。
• 画像若发现项目目录内的本地数据文件（.db/.sqlite/.duckdb），审计可能对其做只读聚合查询 （计数/分布/量级）以核实真实用户画像；不读取明细行、不复制、不上传，报告只写量级不含可识别信息。 不希望被读取时，在 facts.md 任意位置写一行 不要读取本地数据文件 即可。
• market 产出的 market.md 只在本地档案目录；抓取只发 GET、不登录、不带任何项目内容；上报字段不含其内容。
• 可选的「主人档案」~/.value-audit/owner.md（自由格式：公司阶段、收款能力、合规红线、手里的资源等）： 存在时审计与 market 都会把它原文注入 prompt（它可以只写一行"读某个文件/skill"，模型会按指引读取）， 让第 3/4/7 节处方与改造建议贴合你的实际处境，且每条标注引用了哪条档案条目（例如没有对公账户就不会把"签合同收款"开成 P0）。 输出只带条目 id 与结论词，不带档案里的具体日期/数量/账户状态；export 时若报告含 #id 引用会提醒你分享前检查。 它只在本地被模型读取，不复制进报告/facts/journal，不在任何上报字段中；请不要把它放进代码仓库。

反馈问题

遇到 bug、审计质量问题或功能建议，请提 GitHub Issue，建议附上：

• 工具版本（package.json 的 version）与操作系统
• 问题现象（报告片段请自行脱敏，不要贴含商业机密的内容）
• 复现步骤（如能提供）

审计结论不符合预期时，先确认 facts.md 是否如实填写——工具的诚实度取决于输入的诚实度。

Roadmap

• v0.8.1：一页纸 NEXT.md；问答稿默认精简；报告篇幅纪律；引用核实支持同目录省略写法 ✅
• v0.9：意图前置（facts 第 0 节决定审计假设与 P0 方向）；画像折叠嵌套仓库、识别子目录技术栈、 纳入归档任务与 references；本地数据文件提示；引用核实剥离括号说明并区分「缺路径」✅
• v0.10：market 子命令（联网竞品表按热度降序、按 URL 累积合并 + 价格锚点 + 结合主人处境的改造建议）；商业化意图首审自动串联调研； 主人档案确定性注入；联网能力检测与随附抓取脚本 ✅
• v0.10.1：意图未填先问一次再联网；市场资料精简注入与 market 知识库裁剪（省 token）；热度按口径分组（star > 自报 > 无）； facts-draft.md；export 主人档案引用提醒 ✅
• v0.10.2：facts 合并按条目名前缀匹配（改了括号说明不再重复追加）；引用核实点名缺路径片段；同一提交复审写"代码无变化"； 混合意图（自用为主 + 顺带商业化）专用审计假设；画像检测无 git remote 作 [止血] 信号；处方第三方配合只写角色 ✅
• v0.9.1：主人档案 ~/.value-audit/owner.md（处方贴合公司阶段/收款能力/合规红线）；facts 外部证据补录条目 ✅
• 后续：英文报告（按需求决定）

更早版本（v0.1–v0.8：审计闭环、复审对比、决策日志、匿名统计、心理学改造、盈利模型与观测检查、 引用自动核实与 do <ID>）见 Releases。

License

MIT © wwj