recoluan/recowork

RecoWork

让你已经在使用的 AI Agent，持续完成真实工作。

RecoWork 是面向人和 AI Agent 的工作标准与项目事实层。它不替代 Agent runtime，不托管模型，不在后台替你运行任务，也不管理你的 API Key。

它把任务、专业标准、当前事实、验收方式和续接机制固定下来，让一次有价值的对话变成可以继续、检查和复用的工作。

English · 网站 · 使用方式

能解决什么工作

| 真实工作 | RecoWork 固定什么 | 当前模板 |
| --- | --- | --- |
| 从想法推进到项目 | 探索、验证、方向决策包、可重启的搁置想法、项目简报、方案、决策、评审 | idea-to-project |
| 用证据学习 | 诊断、路线、练习、项目实践、复盘 | learning-engineering |
| 提升网页交付质量 | 视觉方向、响应式规则、组件状态、自检 | web-design-standard |

网页设计规范是独立可复用的专业标准，当前单独验证，不把它包装成与项目工作流完全相同的场景。

两种使用环境

本地可执行 Agent

适合长期项目、代码、复杂学习，以及需要持续沉淀或可审查过程的工作。RecoWork 会在你选择的目录中初始化根目录 AGENTS.md、工作方法、适用的本地化工作空间和版本化清单。正式工作文档始终保持当前且精简，确认保留的历史版本统一进入工作空间归档。

Chat / Mobile

适合快速开始、临时任务和轻量对话。它只提供启动指令、任务执行协议和续接/迁移摘要，不要求 Node.js、CLI、本地目录、自动保存、升级或文件级可追溯性。

聊天连续性由你管理：保存并在下一轮对话中粘贴续接摘要。当任务变成长期工作、多人协作、知识沉淀或可审计过程时，使用迁移包新建一个独立的本地工作流。

在本地初始化

在能够执行命令的本地 Agent 中，使用确定性的 CLI 初始化：

npx --yes recowork@latest add idea-to-project --target local-agent-project --locale zh .

按需要换成其他工作场景或语言：

npx --yes recowork@latest list
npx --yes recowork@latest add learning --target local-agent-project --locale zh ./my-learning-work
npx --yes recowork@latest add idea-to-project --target chat-mobile --locale zh ./idea-work

把已有的非空项目安全接入 RecoWork，且不覆盖项目文件：

npx --yes recowork@latest import idea-to-project --target local-agent-project --locale zh ./existing-project

导入只添加缺失的 RecoWork 文件；同名路径保持不变，已有根目录 AGENTS.md 也只会新增带标记边界的 RecoWork 整合区块。

npx --yes recowork@latest 会临时获取并运行当前版本，无需全局安装。只有全局安装 RecoWork 后，才可以直接使用较短的 rw 别名。

让本地 Agent 帮你开始

将下面指令发给能够执行命令的本地 Agent：

请在当前目录初始化 RecoWork 从想法到落地工作流。

执行：npx --yes recowork@latest add idea-to-project --target local-agent-project --locale zh .

先检查 Node.js 和 npm。任一项缺失或版本过旧时，先说明阻塞原因，并向我确认后再安装最新版稳定版 Node.js。若根目录已有 AGENTS.md，保留既有内容，并确认 RecoWork 只新增带稳定标记的整合区块。完成后展示创建的文件，并说明第一步如何开始工作。

纯聊天或手机端请通过网站选择器生成可复制的聊天启动指令；不要在这类环境中运行 CLI 或模拟创建本地文件。

阅读本地工作空间

对于本地工作流，可用内置的只读查看器浏览 Markdown 记录：

npx --yes recowork@latest view .

查看器会在 127.0.0.1 启动，并在可用时打开浏览器；它不会写入配置、重新生成文件或修改工作空间。Markdown 或索引被编辑后，它会自动刷新当前文档和导航；同时支持可复制的文档链接、全文搜索、面包屑与上一篇/下一篇导航、GitHub 风格 Markdown，并优先展示当前工作、按需打开本地化归档。本地 Agent 工作流也会要求 Agent 在初始化完成后，或你要求浏览工作空间时自行启动该命令；同一工作空间的查看器已运行时会自动复用，用户无需全局安装、查找工作空间目录或操作终端。需要时使用 --no-open 或 --port 4311。

能力边界

- Agent 由你控制，RecoWork 不替你运行它。
- 本地项目文件保存在你选择的位置。
- AI 的产出、建议和修改仍需要人工审查。
- RecoWork 不承诺自动记忆、无限执行或无人值守完成。
- 未完成实际兼容性验证前，不将具体 Agent 产品描述为官方支持。

开发

node --check cli/recowork/bin/rw.js
node --check docs/app.js
node cli/recowork/bin/rw.js list
node cli/recowork/bin/rw.js targets
node cli/recowork/bin/rw.js view /private/tmp/recowork-view-test --no-open --port 4311

产品和 target 约定见 specs/requirements.md、specs/targets.md 与 specs/decisions.md。未发布和已发布变更见 CHANGELOG.zh.md。