Kungfu
让同一项工作跨 Agent、故障与会话持续推进。
README 明确说明安装器不使用 sudo、不修改 shell 配置，Kungfu 不会替用户暂存、提交或推送文件；工作流也声明窄化权限、固定部分 Action 提交，并禁用持久化凭据。独立审查、结算和单控制者机制体现了确认与权限分离，工作目录及历史数据流也有一定说明。扣分在于未提供安装器源码、完整运行时权限清单、遥测/网络传输说明或凭据存储实现；敏感数据证据主要是 SECURITY.md 的报告政策，而非处理控制。恢复故事和持久化 Work 支持故障恢复，但所给材料没有完整卸载、数据回滚或外部副作用清单。来源、组织链接和联系渠道清楚，但发布者身份仍未经注册表验证。
README 的 Project、Work、Attempt、单写者及独立结算模型与终端测试中的控制权、输入阻塞、恢复状态和投递结果相互一致，因此自洽性证据充分。测试展示了具体、可操作的状态和失败消息，工作流也大量采用严格校验及明确错误退出。扣分在依赖可用性：真实使用仍依赖 Codex、Claude、OpenCode、Amp 等外部 Agent，项目处于 Alpha，且给定材料没有完整锁文件或支持矩阵内容。
材料覆盖首次体验、故障恢复、多步骤审批、原生 Agent 控制台、TUI/GUI、CLI、API 和贡献者场景，并明确 Mock Agent、真实 Agent、侧边视图、完成权限及演示非认证等边界。命令、环境变量和会话控制条件较精确。扣分在于 Windows、高保障安装、版本兼容和具体 provider 差异仅被链接提及，相关正文未提供；触发行为也未由完整命令实现代码支撑。
README 具有清楚的渐进式信息架构，定义核心术语并把安装、概念、限制、安全、升级和贡献路径分开；安装示例、PATH 提示、Alpha 标识、已知限制入口和完整 Apache-2.0 文本都很明确。产品术语在 README 与测试间稳定。扣分在于没有传统 FAQ 内容，部分示例依赖未提供的文档；更新、迁移和发行历史仅有链接或脚本名称，未给出实际 changelog；维护渠道虽明确，但具体维护人员、响应承诺和经验证的发布主体不清楚。
输出面向实际工作：它保留目标、进度、证据、下一动作和完成状态，并提供跨 Agent 延续、故障恢复、冲突阻止及可读的 UI 状态，形成了明显的增量价值。扣分在成本收益：README 宣称可在重要任务使用最佳 Agent、其他任务使用更便宜 Agent，并称数分钟内见效，但没有量化资源开销、迁移成本、存储增长或与替代方案的比较证据。
核心主张被拆成三个有边界的证明，并指向精确证据制品；README、测试和工作流共同支撑连续性、控制权、失败状态、权限及来源绑定。材料明确区分确定性 Mock 场景与真实 provider、制品演示与生产认证、Agent 产出与独立结算，因此事实和非主张分离充分。满分仅表示静态材料的可追溯结构充分，不表示本次执行或独立验证过这些证明。
- 项目明确处于 Alpha；不要把演示制品或声明徽章视为生产认证。
- 真实工作流仍依赖外部 Agent。使用前应核查其凭据、网络传输、费用和 provider 合规边界。
- 在运行 curl 管道安装命令前，应按安装指南进行版本固定和安装器审查；本次材料未包含 install.sh。
- 不要删除或整体提交 .kungfu/；先检查 workspaceGit 策略，并为重要项目验证备份、卸载和数据恢复流程。
- 发布者身份未经 FollowAgents 企业注册表验证；这表示身份未知，不表示恶意。
这个 Agent 能做什么，适合哪些场景？
Kungfu 是一个面向多 Agent 开发流程的持久化 Work 层，目前以 v4 Alpha 形式公开提供。它把目标、进度、证据、下一步行动和完成状态保存在 Agent 会话之外，而不是保存或转交聊天记录。系统以 Project、Work 和 Attempt 为核心：Project 归集相关工作，Work 保存当前事实，Attempt 记录某个 Agent 的执行及失败。用户可以通过原生 Agent 控制台、`kungfu` CLI、TUI、GUI 或 API 访问同一 Work，并可用 `kungfu run codex`、`claude`、`opencode` 或 `amp` 启动执行。运行状态保存在项目内的 `.kungfu/` 工作区；Kungfu 不会替用户暂存、提交或推送 Git 文件。它适合需要跨 Agent 接续、故障恢复和独立完成审核的团队，但 Alpha 状态和外部 Agent 依赖使其尚不适合作为无需额外验证的稳定生产基础设施。
用户在项目目录中通过 kungfu run <agent> "<task>" 创建并执行 Work，或由现有 Agent 运行 kungfu agent brief 来引导建立首个 Project 和 Work。Kungfu 将 Work 的目标、进度、证据、下一步和完成状态写入项目本地的 .kungfu/ 工作区，并把每个 Agent 的执行记录为独立 Attempt；断连或进程崩溃后，新进程可以继续同一 Work，既有 Attempt 不会被覆盖。kungfu agent map --json 会提供工作区及 workspaceGit 策略信息，供 Agent 在暂存文件前检查。kungfu agent-work-lab 提供 open → watch/tour → try → test → report 的验证流程；无凭据的 Mock Agent 还可通过 recovery-story 和 multi-step 场景测试恢复、提问、审批与待审结果。Agent 只能提交候选结果及证据，最终完成需要经过独立审核和 Kungfu settlement；若同一 Work 已由另一个在线 Agent 持有，Kungfu 会阻止第二个写入者。
- 经常在 Codex、Claude、OpenCode 或 Amp 之间切换的开发者，希望继续同一任务而不复制聊天上下文。
- 需要验证断连和进程崩溃恢复能力的团队，可用确定性的 Mock Agent
recovery-story场景检查本地连续性。 - 要求执行者不能自行批准结果的工程组织，可将候选交付、独立审核与 Kungfu settlement 分离。
- 维护长期或多阶段开发任务的团队，可保留每次 Attempt、当前证据、未完成事项和下一步行动。
- 评估 Kungfu 但尚未配置模型提供商凭据的用户，可先运行内置 Mock Agent 的恢复和多步骤场景。
- 需要跨多个项目查看 Work 的用户，可选择使用 Kungfu TUI 或 GUI 作为全局侧边视图。
这个 Agent 有哪些优点和局限？
- 持久化的是结构化 Work 状态而非聊天记录，可在新 Agent 会话中保留目标、进度、证据和下一步。
- Attempt 模型保留断连与崩溃历史，并允许新进程继续同一 Work而不覆盖失败记录。
- 明确分离执行、独立审核和 settlement，执行 Agent 不能自行宣布 Work 完成。
- 支持 Codex、Claude、OpenCode、Amp 以及自有执行界面，并提供 CLI、原生控制台、TUI、GUI 和 API 入口。
- 内置无需提供商凭据的确定性 Mock Agent，可重复检查恢复和多步骤流程。
- 同一 Work 存在在线持有者时会阻止第二个写入者，降低并发状态静默分叉的风险。
- Kungfu v4 仍处于 Alpha，是预发布渠道，不是稳定或普遍可用版本。
- 常规 onboarding 和独立审核仍需要受支持的真实 Agent，因此 Mock Agent 不能构成完全无外部 Agent 的端到端路径。
- 项目会新增
.kungfu/本地工作区，采用前需要理解并遵守其workspaceGit策略。 - 公开演示仅证明限定场景和精确产物，不构成生产认证、提供商排名或真实 Work 的完成授权。
- 来源只给出 macOS/Linux 的直接安装命令；Windows 安装需另查安装指南。
- 跨 Agent 使用仍要求相应 Agent 可在本地运行命令，Kungfu 本身不会替用户执行 Git 暂存、提交或推送。
如何安装或部署这个 Agent？
在 macOS 或 Linux 上运行 curl -fsSL https://kungfu.tech/install.sh | sh。该按用户安装程序不使用 sudo，也不修改 shell 配置；安装后必须执行它输出的准确 PATH 设置步骤。Windows、高保障安装和显式版本固定在来源中被指向安装指南，但未给出可直接复制的具体命令。通过网络安装需要访问 kungfu.tech；内置 Mock Agent 场景不需要模型提供商凭据。
如何使用这个 Agent？
进入项目目录后，可先运行 KUNGFU_MOCK_AGENT_SCENARIO=recovery-story kungfu，观察同一 Work 经历断连、崩溃和恢复交付的三个 Attempt。较短的检查可运行 KUNGFU_MOCK_AGENT_SCENARIO=multi-step kungfu。要使用真实 Agent，运行 kungfu run codex，也可将 codex 替换为 claude、opencode 或 amp；直接创建任务可运行 kungfu run codex "Prepare the release notes"。若希望留在当前 Agent 界面，让该 Agent 执行 kungfu agent brief 并引导创建 Project 和 Work。出现 .kungfu/ 后不要删除或整体加入 Git；暂存前应运行 kungfu agent map --json 并遵循其 workspaceGit 策略。
这个 Agent 与同类方案有什么区别？
与在 Codex、Claude、OpenCode 或 Amp 之间手动复制聊天和重新解释决策相比，Kungfu 把同一 Work 的目标、证据、进度和 Attempt 历史保存在会话之外。它不是这些 Agent 的替代品，而是让它们共享持久工作状态的协调层；TUI 和 GUI 也只是可选侧边视图，不取代原生 Agent 控制台。
常见问题
试用时需要 OpenAI 或 Anthropic 凭据吗？
recovery-story 和 multi-step 场景不需要提供商凭据；常规 onboarding 和独立审核仍需要受支持的真实 Agent。Kungfu 会自动提交或推送代码吗？
.kungfu/ 内容前应运行 kungfu agent map --json 并遵循 workspaceGit 策略。