teaql-agent-kit

给 AI 编程搭好稳固底座，放心交给它写大项目。

开源 🏷️定价信息待确认 ✅ 目前可打开编程开发 🍴 复刻 954 🐛 待处理 2 👀 关注 99

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 2819

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

teaql-agent-kit 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类编程开发

开发团队teaql

官网地址https://teaql.io

GitHubhttps://github.com/teaql/teaql-agent-kit

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agentic-coding,ai-agents,ai-coding,ai-native,code-generation,coding-agent,context-management,ddd,developer-tools,domain-driven-design,harness-engineering,java,model-driven-development,progressive-disclosure,rust,semantic-guardrails,semantic-modeling,teaql

GitHub 星标★ 2819

上线时间2018-12-17 00:00:00

代码更新2026-11-10

仓库体积39.3 MB

本站数据更新2026-11-10

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

以模型为中介的智能体软件开发框架，为可靠的代理式编程提供稳定底座。通过精心设计的编排机制，让 AI 代理在复杂任务中保持正确方向，减少幻觉与失控，交付更可信的软件成果。

Star 增长趋势

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

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

技术标签

agentic-coding ai-agents ai-coding ai-native code-generation

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 10 分钟部署方式：命令行工具 6 步

环境要求

Node.js 环境（npx，用于安装社区 Skills CLI）
Python 3 环境（用于执行 ./tools/teaql_workspace.py 脚本）
支持 Skills 的编码代理（用于调用 $build-teaql-app 工作流）
本仓库源码（tools/ 与 examples/ 目录需在本地可用）

安装与启动步骤

1获取项目仓库

克隆 teaql-agent-kit 仓库到本地，tools/ 下的工作区脚本和 examples/ 下的配置样例都在仓库内。
```
git clone https://github.com/teaql/teaql-agent-kit.git
cd teaql-agent-kit
```
2安装 Agent Skill

用社区 Skills CLI 安装完整“模型到应用”工作流技能 build-teaql-app，装好后即可在编码代理中使用。
```
npx skills add teaql/teaql-agent-kit --skill build-teaql-app
```
3在代理中调用技能

向编码代理发出提示，先用 $build-teaql-app 起草并保存完整 KSML 模型，再评估修复、生成可运行应用。
```
Use $build-teaql-app to first draft and save a complete KSML model, then
evaluate and repair it before generating a runnable TeaQL application: ...
```
4准备工作区配置

从 examples 里的样例复制出 teaql-workspace.yaml，该文件使用 JSON 兼容 YAML，验证器无需第三方依赖。workspace 版用于改运行时，release 版用于已发布包回归。
```
cp examples/teaql-workspace.release.yaml teaql-workspace.yaml
```
5应用运行时源

apply 会解析配置中选定的运行时仓库（workspace 模式记录精确 commit 与 dirty 状态），并在目标应用工作区写入证据文件。
```
./tools/teaql_workspace.py apply \
  --config teaql-workspace.yaml \
  --workspace /path/to/generated-application
```
6校验运行时源

verify 按配置校验所选运行时仓库，应在执行 Maven/Cargo/Go/npm 等原生包管理器命令之前完成。
```
./tools/teaql_workspace.py verify --config teaql-workspace.yaml
```

关键配置

配置项	必填	说明	示例
`runtimeSource`	是	选择运行时来源：workspace 解析七个运行时仓库并记录 commit 与 dirty 状态；release 要求包版本、拒绝路径覆盖	`release`
`--workspace`	否	apply 的目标应用工作区路径，证据文件会写入该工作区	`/path/to/generated-application`

如何确认成功

执行 verify 命令无报错即通过；apply 后在应用工作区可见 .teaql/runtime-source-evidence.json 证据文件。

常见问题

Q：需要预先安装什么环境？

A：需要 Node.js 以使用 npx skills 安装技能，并用 Python 3 运行 tools/teaql_workspace.py 脚本；仓库使用 JSON 兼容 YAML，验证器无第三方依赖。

Q：runtimeSource 该选 workspace 还是 release？

A：workspace 会解析七个运行时仓库并记录精确 commit 与 dirty 状态，适合正在修改运行时；release 要求声明包版本并拒绝路径覆盖，适合已发布包的回归验证。

Q：安装技能后怎么触发工作流？

A：在编码代理中提示 Use $build-teaql-app，先起草并保存完整 KSML 模型，再评估修复，然后生成可运行的 TeaQL 应用。

Q：可运行的完整示例在哪里？

A：Agent Kit 只定义共享的 harness 模式，可运行应用放在语言专属仓库 teaql-java-app-examples 与 teaql-rust-app-examples 中。

注意事项

本仓库是编排/治理框架，本身不是可直接运行的业务应用，端到端运行效果需参考 Java/Rust 应用示例仓库。
生成的应用清单只声明已发布的 TeaQL 依赖，不会包含维护者本地文件系统路径。
原生包管理器 override（Maven、Cargo、Go、npm、Swift、.NET、Python editable 等）由工作区自行维护，生成器不会创建或猜测。
运行时治理只让应用动作具备上下文、边界、可观测与可审计，并不替你选择正确的业务策略。