- 来源
- 当前版本
- 验证时间
先写规格 — 再让 AI Agent 照着构建
给每个 Agent 一份契约。在确认完成之前先验证代码。
Planu 将需求转化为获批的规格,让实现保持一致,并依据明确的验收标准验证结果。
商业和非商业用途均可免费使用 · 兼容的 Node.js 运行环境 · 开始时无需 Planu API 密钥
构建时验证
展示产品事实,而不是装饰性计数器。
Clear released specs from the pending release ledger
Make the release commit the atomic source of truth for which pending specs were published, while preserving any ledger entry created or updated after the immutable release-base snapshot.
- 已批准
- 实现中
- 已完成
验收标准
- AC1GIVEN `planu/releases/pending.json` contains valid entries at `RELEASE_BASE_HEAD`, WHEN the release commit is created, THEN every current entry with the same complete `{specId,title,completedAt}` identity is removed, and a shared cross-process lock makes entries added or changed after the snapshot—including an append attempted during reconciliation—remain.
- AC2GIVEN release execution resumes before or after the release commit, WHEN pending reconciliation runs, THEN it derives the same snapshot from the persisted `RELEASE_BASE_HEAD`, is idempotent, and never repeats mutation after `release-commit` is recorded; `tests/integration/release-pipeline-recovery.test.ts` line 4 changes the recovery expectation.
- AC3GIVEN dry-run mode, a missing/empty snapshot, or malformed snapshot/current JSON, WHEN pending reconciliation is evaluated, THEN dry-run performs no write, missing/empty snapshot preserves current state, and malformed data exits non-zero without changing the current file.
- AC4GIVEN release 4.11.17 publishes the currently queued specs, WHEN delivery completes, THEN `planu/releases/pending.json` is empty, npm exposes 4.11.17, and `main`, `develop`, and `release` resolve to the same release commit.
d589ca65c带来的改变
减少重复理解,改善审查,让交付可验证。
意图持久化
需求保存在可审查的规格中,而不是消失在聊天记录里。
受控实现
审批和就绪检查为每个 Agent 提供相同边界。
done 前提供证据
验证会依据已接受的标准检查交付代码。
一份契约,多个 Host
切换 Agent 时保留工作流。
Planu 将同一本地规格生命周期连接到 Claude Code、Codex、Cursor、Windsurf、Gemini CLI 及其他支持的 MCP Host。
查看支持的工具- Claude Code
- Codex
- Cursor
- Windsurf
- Gemini CLI
- OpenCode
- 可读的本地项目工件
- 开始时无需 Planu API 密钥
- 明确记录遥测与集成边界
与用户共同打磨
使用 Planu,并帮助它变得更好。
官方且未经修改的 Planu 软件包可免费用于商业和非商业工作。代码仓库和 TypeScript 实现保持私有和专有;分发的 JavaScript 可读。您可以通过捐赠支持独立开发,或分享 Planu 为您的工作流程带来的改进。
$ npx -y @planu/cli@latest install
让下一个 Agent 从规格开始。
安装一次,描述一个真实功能,完成第一次验证闭环。
打开安装指南