agent-spec

给 AI 代理定验收标准,任务执行不跑偏

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 编程开发 🍴 复刻 36 🐛 待处理 9 👀 关注 2
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 463
维护状态 维护中
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,无付费版本。

项目预览

agent-spec 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类编程开发
开发团队ZhangHanDong
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Rust
技术栈/模型agent,ai-coding,sdd,spec
GitHub 星标★ 463
上线时间2026-03-07 00:00:00
代码更新2026-08-29
仓库体积3.8 MB
本站数据更新2026-11-10
维护状态维护中
收录时间2026-08-09
浏览次数6

项目介绍

agent-spec 是一个 AI 原生的 BDD(行为驱动开发)规格验证工具,专为 AI 代理的任务执行场景设计。它解决的核心问题是:AI 代理在自主执行复杂任务时,往往缺乏明确、可验证的验收标准,导致输出结果难以评估和纠偏。该工具允许开发者用自然语言或结构化格式定义任务规格(spec),并将其转化为可自动执行的验证断言,在代理运行过程中实时校验其行为是否符合预期。基于 Rust 实现,具备高性能和低延迟特性,能够无缝集成到现有 AI 代理工作流中,提供规格解析、执行跟踪、结果比对和失败反馈等核心能力,帮助团队确保 AI 任务交付的质量与一致性。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 463

技术标签

使用教程

难度:进阶 约 35 分钟 部署方式:本地安装 5 步

环境要求

  • 一个支持规范的编码代理
  • 命令行工具

安装与启动步骤

  1. 1装成规范文件

    把它给的项目约定文件复制到项目根。

    cp AGENTS.md /path/to/your/project/
  2. 2先渲染契约

    让它把任务规格转成可验证的契约。

  3. 3生成实现提示

    带代码上下文的提示比空口描述有效。

    agent-spec plan <spec> --code . --format prompt
  4. 4跑任务级校验

    实现完先过这一关。

    agent-spec lifecycle
  5. 5跑仓库级校验

    需要时再全量查。

    agent-spec guard

如何确认成功

按流程实现一个带明确验收标准的任务后,任务级校验通过且能指出未绑定的可观察行为

注意事项

  • 它把行为驱动的验收标准引入代理任务,解决的是「做完但不知道对不对」的问题。
  • 流程是契约先于实现,跳过契约直接写代码就失去了它的价值。
  • 改写或迁移类任务要先用工具查还有哪些可观察行为没被绑定。
  • 两份代理约定文件分别对应不同宿主,按自己用的那个复制。

核心亮点

  • 将 BDD 理念引入 AI 代理,用可执行规格替代模糊提示,显著提升任务结果的可验证性
  • Rust 实现,性能开销极低,适合高频实时校验场景
  • 支持自然语言定义规格,降低使用门槛,开发者上手快

不足之处

  • 早期项目,生态和文档尚不完善,社区支持待观察
  • 仅聚焦规格验证环节,未覆盖代理编排或记忆管理等其他 AI 工程链路

适用场景

  • AI 编码代理的代码生成结果自动校验
  • 自动化测试中为 AI 生成的测试用例设定验收标准
  • 多步骤 AI 任务执行过程中的里程碑检查

替代项目

Cucumber、Behave、Pester

上一篇:awesome-codex-cli

下一篇:code-context-engine

同类项目推荐

langchain-teddynote 开源

让韩语开发者用更少代码快速搭起 LangChain 应用

LangChain 을 더 쉽게 구현하기 위한 유틸 함수, 클래스를 만들어서 패키지로 배포하였습니···

★ 126 2026-08-09
aici 开源

把提示词变成程序,动态控制AI生成过程。

AICI: Prompts as (Wasm) Programs

★ 2073 2026-08-09
ai-elements-vue 开源

用 Vue 快速搭建 AI 聊天界面,省时又专业

AI Elements Vue is a component library built on top of shadcn-vue to help you build ···

★ 1201 2026-08-09
node-diffusion 开源

像搭积木一样可视化 Stable Diffusion 的生成过程

Organize latent space

★ 52 2026-08-09
llmflows 开源

像画流程图一样构建 LLM 应用,每一步都清晰可控。

LLMFlows - Simple, Explicit and Transparent LLM Apps

★ 709 2026-08-09
ollama4j 开源

用 Java 轻松调用本地 Ollama 模型,快速集成 AI 能力

A simple Java library for interacting with Ollama server.

★ 508 2026-08-09
h5i 开源

本地一键拉起隔离沙箱,让 AI 代理安心跑代码

An Axum-based Rust web framework with Lean 4-verifiable application kernels that run···

★ 915 2026-08-09
python-ai-agent-frameworks-demos 开源

照着示例跑通多个 Python Agent 框架,快速接入 Azure OpenAI

A repository of examples using Python AI Agent frameworks that work with GitHub Mode···

★ 339 2026-09-12
spring-ai-alibaba 开源

Java 团队用 Spring 方式快速搭建多智能体应用

Agentic AI Framework for Java Developers

★ 11129 2026-10-11