Agent-Kit：构建自主编码工作流的技能、代理与规范框架

Agent-Kit是一个开源框架，通过OpenSpec规范、MCP任务中心和自动化GitHub Actions工作流，为OpenCode和pi编辑器提供完整的自主编码代理基础设施，支持技能管理、任务编排和状态追踪，实现"想法到代码"的闭环。

随着AI编程助手从简单代码补全工具演进为能独立规划执行任务的"代理"，开发者对结构化工作流的需求日益迫切。Agent-Kit正是这一趋势的代表性解决方案，为自主编码代理提供完整基础设施。

三层仓库设计

采用agent-kit（源码）、agent-template（脚手架）、mcp-task-hub（Docker化任务服务）的三层架构，通过GitHub Actions自动同步变更。

技能系统

技能存于.agents/skills/目录，支持OpenCode自动发现，包含shared（通用）、opencode/pi（编辑器特定）细分目录，核心技能有agentic-setup（项目引导）和mcp-hub-setup（任务中心配置）。

MCP任务中心

基于FastAPI的Docker服务，提供集中式状态管理，任务以TaskMD格式存储并生成Git Note审计记录，支持多代理协作与跨会话恢复。

代理编排

• pi编辑器：通过/hub-run命令端到端执行任务，循环清空队列
• OpenCode：提供@hub-runner（单任务）、@hub-orchestrator（批量并行）等选项

OpenSpec集成

通过/opsx-propose命令将想法转化为OpenSpec规范，生成任务列表同步到Hub，实现规范驱动开发。

GitHub Actions自动化

sync-template.yml和sync-hub.yml工作流自动同步变更，需TEMPLATE_REPO_TOKEN和OPENROUTER_API_KEY密钥。

快速入门

1. 克隆mcp-task-hub启动Docker服务
2. 克隆agent-template作为新项目基础
3. 配置openspec/config.yaml和AGENTS.md
4. 启用Git Note功能

工具链生态

整合MCP协议（Anthropic开源）、TaskMD、OpenSpec、OpenCode和pi编辑器等开源工具，提供官方文档链接。

局限性

• Mode B依赖OpenRouter API密钥
• GitHub Actions自动化PR需人工审查
• 任务中心单机部署限制团队协作

未来方向

• 支持多Hub联邦架构
• 更细粒度权限控制
• 集成更多AI编辑器
• 基于Git Note的智能分析功能

Agent-Kit代表从"AI助手"到"虚拟同事"的范式转变，为组织提供规范驱动、状态外置、人机协作的工作方式参考。它是连接AI潜力与工程实践的桥梁，推动自主编程未来发展。