title: "Servo" status: active updated: 2026-06-01 owner: servo-kernel last_verified: 2026-06-01

Servo

一个 Codex-first 的 AI coding harness 平台，通过 repo-side contract layer 实现可控的 AI 编程工作流。

本项目由作者与 AI coding agents 协作推进：主要协作伙伴是 GPT/Codex，DeepSeek 也参与部分分析、实现和验证工作。

安装 Skills

确保有 Node.js 18+，在目标仓库根目录安装 Codex / agents backend 的 Harness Skills：

npx servo-installer
npx servo-installer tui

测试 RC 时使用 next selector：

npx servo-installer@next
npx servo-installer@next --version

交互式终端中，已批准 package entrypoint 可以进入最小 TUI；CI、脚本或非交互环境应使用显式 CLI：

npx servo-installer --version
npx servo-installer diagnose --backend agents --json
npx servo-installer verify --backend agents
npx servo-installer update --backend agents
npx servo-installer update --backend agents --yes
npx servo-installer install --backend agents

当前 public / near-public 主路径仍是 agents backend，也就是 Codex 使用的 .agents/skills/ payload。推荐从目标仓库根目录先做只读观察，再显式 apply：

npx servo-installer diagnose --backend agents --json
npx servo-installer update --backend agents
npx servo-installer update --backend agents --yes
npx servo-installer verify --backend agents

进阶安装、TUI、文件软连接和 Claude Code backend 见：

• 快速入门教程 — 新用户先读这里
• 推荐使用流程
• Codex / agents 后端
• Claude Code 后端

使用 Skills

以 Codex 为例

初始化仓库

目标仓库还没有 .servo/ 时，先初始化 Harness 控制面：

$harness-skill 初始化当前工作目录的 harness 环境，初始化当前工作目录的 git 环境。

设置仓库 Final State

需要明确或重设仓库最终状态时，给出目标、非目标、验收标准和约束：

$set-harness-goal-skill 当前仓库期望最终实现一个 [目标描述]。

如果是对已有 Goal Charter 做方向变更，走目标变更控制：

$repo-change-goal-skill 将当前仓库目标调整为 [新目标]，变更理由是 [原因]。

追加临时任务或者补充需求

已有目标后，追加一个临时任务、新功能、设计请求或当前 worktrack 的补充需求：

$repo-append-request-skill 补充一个功能：[要新增或补充的内容]；边界是 [希望包含什么，不包含什么]。

Harness 会把请求分类为 new worktrack、scope expansion、design-only、design-then-implementation 或 goal change，再给出下一步路由。

场景指南

| 场景 | 文档 | |------|------| | 新用户快速入门 | quickstart.md | | 已有代码项目初始化 Harness | init-with-code.md | | 空项目从零开始 | init-greenfield.md | | 推荐使用流程 | recommended-usage.md | | 调整目标 / 追加需求 | goal-change-guide.md |

仓库维护者

内部结构说明、目录分层、入口分工和项目机制见 Repository Onboarding、Docs 和 AGENTS.md。

许可证

MIT License，以根目录 LICENSE 文件为准。

友情链接

LinuxDo[https://linux.do/]