Repo 原生 Artifacts
项目指令、Spec、Prototype、Plan、Review、验证证据和 Commit Intent 都沉淀在 Repo，让人和 Agent 读同一份事实。
AI Native Dev
面向 AI Agent 开发的 Repo 原生工作流闭环。
先对齐 context，处理不确定性，评审计划，验证行为，再把提交意图留在 Repo，而不是丢在聊天上下文里。
安装
先把 Repo 协作协议安装到本地。
本地路径提供一套具体的协议执行方式，不要求账号，不依赖托管后台，也不要求你先公开 GitHub 仓库。
安装到 Codex
npx skills add https://skill.ferryman.app --global --yes --agent codex
安装到 Claude Code
npx skills add https://skill.ferryman.app --global --yes --agent claude-code
查看协议动作
npx skills add https://skill.ferryman.app --list
第一步
用vibe-project初始化项目指令。
安装后重新打开Codex thread或重载agent session，然后在目标Repo里运行这条提示。
复制第一步提示
用vibe-project为当前Repo创建或更新项目级instructions。Codex更新AGENTS.md；Claude Code更新CLAUDE.md。
-
Codex
AGENTS.md -
Claude Code
CLAUDE.md
产品模型
把共享上下文变成可复查的工程工作。
组织级 Skills
把对齐上下文、验证未知、评审 Spec 和 Plan、沉淀测试证据、保留 Commit 意图变成可复用、可版本化的工作单元。
可信 Workflow Events
未来可以通过 hooks 和 CI 记录紧凑、可追溯的事件，关联 spec、review、plan、test、commit、运行结果和人工确认。
工程可观测性
团队未来不用翻聊天记录，也能看到协议采用、Spec Lead Time、Review Gate、Test Evidence 和 Commit 质量。
工程可观测性
衡量流程和质量，而不是表演式统计 AI 使用量。
当前产品是本地 skill bundle。更长期的价值是：这些 Repo 内 artifacts 可以演进成可信 workflow events，让团队看到工作是否从意图，走到已评审的 Spec、已评审的 Plan，再到有测试证据、可复查的 Commit。
-
01
Spec Lead Time
来源：spec.created 到 spec.ready 或 spec.reviewed:ready。
需求从意图到可开发状态需要多久？ -
02
Spec Adoption Rate
来源：由 vibe-spec 创建或更新的 spec 文件。
团队是否真的用 Repo 原生 spec 协议定义需求？ -
03
Plan Adoption Rate
来源：包含 vibe-plan 实现与验证计划的 feature。
团队是否在开发前先定义实现路径和验证方式？ -
04
Test Coverage
来源：优先使用 CI coverage report；没有覆盖率报告时使用 test evidence coverage。
实现是否有可度量、可复查的验证证据？ -
05
Commit Adoption Rate
来源：由 vibe-commit 生成结构化证据的 commit。
Commit 是否保留了意图、影响面和验证证据？
工作流环节
- Spec 创建
- Spec 就绪评审
- 实现与验证计划
- Plan 就绪评审
- 开发执行
- 验证证据
- 代码与证据评审
- Commit 准备
- CI 覆盖率
采用信号
- skill name
- event type
- artifact path
- plan_ref
- outcome
- timestamp
- evidence_ref
质量 / 效率问题
- Spec 协议是否被采用？
- Spec 多久进入可开发状态？
- 开发前是否先规划并评审实现与验证？
- 开发是否按计划执行？
- 是否存在覆盖率或验证证据？
- 提交前是否完成代码评审？
- Commit 是否保留了实现意图？
协议执行层
让开发闭环默认保留 context。
每个工作流动作都把脆弱的聊天上下文变成可重复的 Repo 原生步骤：对齐项目指令、定义功能、用原型处理未知、评审 Spec 和 Plan、沉淀测试证据、评审代码、必要时交接、保留 Commit 意图，并准备 Release Notes。
工作流技能
vibe-project
创建项目级 Agent Instructions，让编码代理共享同一套工作规则和 Repo context。
工作流技能
vibe-spec
把产品意图、issue 记录、截图、原型和取舍沉淀成遵循项目工件目录的 Repo 内 feature spec。
工作流技能
vibe-review
按目标类型评审 Spec、Plan、代码 diff、文档或 workflow artifact 是否能进入下一步。
工作流技能
vibe-plan
把 ready spec 拆成 vertical slices，并明确验证、架构检查和 Human Review 点。
工作流技能
vibe-prototype
用一次性证据回答一个产品、UI、后端、Agent workflow、prompt 或架构未决问题。
工作流技能
vibe-test
检查测试覆盖度、执行测试用例、沉淀验证证据，并给出测试优化建议。
工作流技能
vibe-screenshot
用真实 App UI 生成商店、发布和营销截图，并完成外层合成与视觉 QA。
工作流技能
vibe-handoff
用简洁 artifact pointers、验证状态、阻塞项和下一步在 agent sessions 之间交接工作。
工作流技能
vibe-commit
把变更意图、影响面和验证证据保留在 Commit Message 里，而不是丢在聊天上下文里。
工作流技能
vibe-release
创建简洁 release 文档，开头包含中英文 Release Notes，并沉淀已发布变更、验证、风险、回滚和链接。
本地化执行
协议执行层安装后就在你的项目里运行。
安装一次；工作流留在Repo里，所有编码Agent都读取同一套上下文。