中文 · English
Lodestar 是一套跑在 Claude Code 上的结构化开发流程，把模糊想法拆成 需求 → 设计 → 计划 → 开发 → 发布 五个能独立验收的环节。
它不替你保证做出好产品——它保证的是：每一环都有明确的「什么算完成」；确定性的事（编译/测试）由程序卡死、过不了不许收工；不确定的事（需求、审查）追问到清楚为止。
做法就三条：
- 确定性判断交给程序（hook，即 Claude Code 的钩子脚本）：编译/测试不过，收工被卡死，不只信模型说的「应该没问题」。
- 审查交给没参与开发的子代理：一颗没参与开发的干净脑子，才审得准。
- 规则从真实失败里长：踩了坑才立规则，没用的主动删——规则只许更精练，不许越堆越多。
需求 ──→ 设计 ──→ 计划 ──→ 开发 ──→ 发布
追问要 翻成具 拆成可 每个 隐私审计
做什么 体决策 验收的 切片走 + 打包
(可选) 切片 四步审计
每环产出一份文档（需求落进 git 的 docs/spec.md，其余工作稿落 .lode/、默认 gitignore），作为下一环的输入——AI 跨环节不靠记忆，靠这些文档。
什么是切片：一块独立、能单独验收的开发工作。计划阶段（
lode-plan）把目标拆成若干切片，开发时逐个做、逐个验收，做完一个再下一个。
四步审计（每个切片必走，按「确定性 → 判断」排序）：编译验证 → 测试完整性 → 代码审查 → 功能测试。前两步交给门禁实跑，后两步交给子代理/人，全过才算 Done。
测试绑需求：每个切片的「验收场景」在计划阶段先于开发定，测试照场景写、审查照场景验——堵住「测试绿但功能跑偏」。
不用背这张表——日常你只敲
/lode-spec或/lode-auto，其余框架按需自动调用/串联；下表是各技能干嘛的参考。 命令 = 技能名（slash 命令就是 skill 名；模型也会按 description 自动触发）。
主线（①→⑥）：
| # | 命令（= 技能名） | 干什么 | 产出 |
|---|---|---|---|
| 1 | /lode-spec |
把模糊想法追问成可开发需求；开局把现状图备好（改现有代码时走 delta=只写"改什么"） | docs/spec.md + architecture.md |
| 2 | /lode-brief |
把"感觉"翻译成具体设计决策（可选） | .lode/design/ |
| 3 | /lode-design |
出高保真设计 / 可交互原型（可选） | mockups/ |
| 4 | /lode-plan |
拆切片（改现有代码时带影响分析/迁移/基线） | .lode/plan/ |
| 5 | /lode-build |
按计划开发，走四步审计闭环 | 代码 + per-slice commit |
| 6 | /lode-release |
隐私审计 + 打包发布（团队走 PR/CI） | Release |
「代码侦察」（读现有代码出
architecture.md）已并入lode-spec开局，不再是单独命令；遇到大型/陌生代码库，spec 会派lode-recon子代理（见agents/lode-recon.md）用干净脑子去读。architecture.md是任何项目都有的活地图，由 spec 建立、build 持续更新。
扩展（按需）：
| 命令（= 技能名） | 用途 |
|---|---|
/lode-auto |
自动驾驶：给一个目标，agent 拆里程碑→切片跑到底，进度账本可续可审 |
/lode-order |
写一条好 执行令（目标/标准/验收/约束/执行策略） |
/lode-review |
派没参与开发的子代理独立审查（含回归/安全/可追溯） |
/lode-fix |
复现→定位→最小修复→回归 |
/lode-skill |
造新技能：给完整能力，别拆碎工具 |
/lode-evolve |
把真实失败沉淀成规则（自进化引擎） |
/lode-init |
项目初始化（可选手动逃生口）：正常由 spec/build 自动铺，本命令仅用于手动预铺 / 自动没生效时补救 |
前置：Claude Code。
插件装（推荐）——在 Claude Code 里两行：
/plugin marketplace add Leejaywell/lode-skills
/plugin install lodestar@lodestar装完直接用。规则、门禁、verify.sh 全由流程自动铺，你不配置任何东西。
脚本装（没插件系统时）——一行，效果一样，只是命令为裸 /lode-spec（无 /lodestar: 前缀）：
curl -fsSL https://raw.githubusercontent.com/Leejaywell/lode-skills/main/install.sh | bash更新：插件——/plugin marketplace update lodestar 再 /plugin update lodestar@lodestar；脚本——重跑上面那条 curl … | bash（幂等覆盖，门禁不会重复挂）。更新后新开 session 才生效（hook 在 session 启动 / 收工时读取），你项目里已生成的 .lode/ 产物不受影响。
卸载：插件 /plugin uninstall lodestar@lodestar；脚本 bash ~/.claude/lode-uninstall.sh。你项目里的 .lode/ 产物默认保留。
细节（门禁怎么挂、文件装在哪、
LODE_NO_HOOKS/--purge-project）见install.sh运行时打印的说明。
日常你基本只敲 1 个命令——其余技能框架在该用时自动调用/串联，不用你记：
| 你想干嘛 | 敲这个 |
|---|---|
| 给个目标，全自动做完（推荐） | /lode-auto 把<目标>做完 |
| 想自己一步步来，从理需求开始 | /lode-spec |
| 给现有项目加功能 / 改老代码 | 还是 /lode-spec（它开局自动摸清现状） |
| 修一个 bug | /lode-fix |
给一个目标,它自己判从零新建/改现有代码、单人/团队,拆里程碑→切片,逐个走四步审计+回归,维护进度账本(崩了能续),偏离重规划、卡住熔断(连败或超预算就停下交给你)。你只在审 PR和接住熔断时出现。
/lode-spec # 理清需求 → docs/spec.md
/lode-plan # 拆切片（每切片先定验收场景）→ .lode/plan/
/lode-order # 写单个切片的执行令，发给 AI 跑 → 四步审计闭环
- 要设计稿就在 plan 前插
/lode-brief（+可选/lode-design）；收尾/lode-release。 - 其余技能（recon / review / init…）框架会在该用时自动调，你不用主动敲。
Lodestar 全程文档驱动——AI 跨环节不靠记忆、靠这些文档；你也通过它们看进度、改需求。文档分两处放，按「该不该进 git」分：
docs/（进 git，是你的交付物）
| 文件 | 是什么 | 你要不要管 |
|---|---|---|
spec.md |
需求的唯一持久真相源：当前到底要做什么。就地演进、旧条目归档、不膨胀 | ✅ 最该看的一份；需求变了就在这改（或让 AI 改） |
spec-changelog.md |
需求变更流水（一行一条：日期 / 改了啥 / 为啥） | 想回溯「需求怎么变到今天」时看 |
architecture.md |
代码现状的活地图（架构 / 约定 / 接口）。spec 建立、build 每切片更新，跨周期常驻 | 回顾 / 审查「这套代码长啥样」时看 |
.lode/（运行态工作稿，默认 gitignore、不进库）
| 文件 | 是什么 | 你要不要管 |
|---|---|---|
plan/<功能简称>-<日期_时间>.md |
开发计划：切片拆分 + 每片的验收场景。每次 replan 另存新版、不覆盖，留演进史；下游读最新 | 想知道「拆了几片、每片要满足啥 / 计划怎么变的」时看 |
changelog.md |
每个切片做了什么——仅非 git 项目兜底；git 项目里这事记在 per-slice commit 里 | 非 git 项目想看「这轮都改了啥」时看；git 项目看 git log |
design/<功能简称>-<日期_时间>.md / mockups/ |
设计规范 / 原型（用了 /lode-brief·/lode-design 才有）。每次重出另存新版、不覆盖 |
关心设计方向时看 |
verify.sh |
把本项目「编译 + 全量测试」封装成一条命令，收工门禁会实跑它 | 一般不用动；没配好时门禁会提示你补 |
goal.md / ledger.jsonl |
自动驾驶的目标 + 进度账本（崩了能续、跑完能审计） | 用 /lode-auto 时想看进度 / 审计就看 |
signals.jsonl / proposals.md |
自进化：你的纠正信号队列 + 沉淀出的规则建议 | 不用管，/lode-evolve 会消化 |
.building · review-passed · .verify-green · .gate-attempts |
门禁记账：武装标记 / 审查标记 / 验证缓存 / 熔断计数 | 完全不用管，程序自动生成与重写 |
两分原则：
docs/（spec*.md+architecture.md）是持久、进 git 的交付物——需求与代码现状两张图，供回顾/审查、跨机器跨队友不丢；.lode/全是工作态——要么周期内用完即清（plan / design / 非 git 时的 changelog），要么可重建（verify），要么纯记账（ledger / signals /.building/ 门禁缓存）。.gitignore应忽略.lode/、跟踪docs/——lode-spec/lode-init开局会自动配好，你不用手动设。顶层还有一份项目根的
CLAUDE.md（Lodestar 的运行约定，自动铺设）——它约束 AI 怎么跑循环，正常你不用动它。
精简主线按一个人 · 从零新建 · 第一版来调校；靠两个开关扩到更复杂的场景（lode-auto 开局自动判断，你不用手动设）：
两种项目情况：从零新建 = 还没有任何代码、从头做一个新东西；改现有代码 = 项目已经有一套代码，你要在上面改或加功能。
- 从零新建 ↔ 改现有代码：改现有代码时，spec 开局自动把现状摸清成一张系统地图（大库派
lode-recon子代理去读），需求按"改什么"写（delta），计划做影响分析/迁移/基线，验证跑全量回归（把原来好的也一起测，别改坏）。 - 一个人 ↔ 多人团队：一个人用本地
review-passed门禁；多人/长期项目切到 PR/CI 门禁，子代理审查降为 PR 前的预筛（不替代人来审）。 - 涉及安全/合规：再加强制安全审查 + 需求-代码-测试能一一对应。
从零新建走最简流程；要改现有代码、或多人协作，才上更重的护栏。自动跑 ≠ 没人管：即便用 lode-auto 全程自动，你仍要在「审 PR」和「接住熔断」两处出现。
小活就轻走：改十行 / 配置这种，spec 一句话、plan 一个切片、跳过设计都行——门禁只在开发开始才咬；大活 / 老项目 / 团队才上全套。
- 少造工具，多给能力 —— 别把一项能力拆成一堆专用小工具，那样反而笨；给完整的通用能力，让模型自己组合。模型的聪明是放出来的，不是设计出来的。
- 规则不要提前写，踩了坑再立 —— 一条规则必须对应一次真实失败；删了它问题会复现，才配留着。没踩过的坑不立规则，立了没用的主动删。
- 把劲花在设计上，不在钉哨上 —— 别再琢磨提示词；真正值钱的是把流程和循环设计好（每环产出什么、什么标准算过、踩坑怎么办、怎么进化），剩下交给 AI 自己决定。
| 概念 | Claude Code 机制 | 本仓库位置 |
|---|---|---|
| 13 个技能 | SKILL.md 技能 |
skills/lode-* |
| 顶层规则 | CLAUDE.md |
CLAUDE.md |
| 独立子代理（审查 / 代码侦察 / 进化） | Agent 工具 + 子代理 |
agents/lode-{review,recon,evolve}.md |
| 确定性规则 → 门禁 | Hooks（插件 hooks/hooks.json / 项目 .claude/settings.json） |
hooks/ |
| 自进化（signals→proposals→规则库） | CLAUDE.md 规则库 + lode-evolve（开局 hook 自动提醒） |
CLAUDE.md + skills/lode-evolve |
| 文档驱动 | 交付文档 + 运行态 | docs/（进 git：spec* / architecture）+ .lode/（gitignore：plan / design / verify.sh …） |
| 执行令 = 目标+标准+验收+约束+执行策略 | 结构化执行令 | skills/lode-order |