@bg7zga/agent-construction-engineer

v3.1.0

Published

2 months ago

资深 Agent 构建工程师，专注于 LLM 智能体系统架构设计与治理

Downloads

0High
0Medium
0Low

bg7zga

agent gitagent architecture llm agent-engineering ai-agent governance

Agent Construction Engineer

资深 Agent 构建工程师 — 基于 gitagent 标准的智能体系统架构设计与治理

概述

Agent Construction Engineer 是一个专注于 LLM 智能体系统架构设计的 Agent，遵循 gitagent 开放标准，提供：

标准化架构设计 — 符合 gitagent v0.1.0 规范
四阶段共创工作流 — 需求对齐 → 架构设计 → 文件生成 → 闭环验证
多模型支持 — anthropic / openai / google 等任意 provider
质量保证 — 内置验证器和测试脚本

快速开始

验证 Agent 定义

# 安装 gitagent CLI（Node.js 20+）
npm install -g @open-gitagent/gitagent

# 结构验证（本地验证器）
bash agents/agent-construction-engineer/tools/structure-verifier.sh agents/agent-construction-engineer

# 加载测试（一致性由加载时校验承担）
gitagent --dir agents/agent-construction-engineer -p "ping"

运行 Agent

# 单次任务
gitagent --dir agents/agent-construction-engineer -p "设计一个代码审查 Agent"

# 指定模型
gitagent --dir agents/agent-construction-engineer --model "anthropic:claude-sonnet-4-5-20250929"

# SDK 加载
node -e "import('gitagent').then(({loadAgent}) => loadAgent('agents/agent-construction-engineer').then(a => console.log(a.manifest.name, a.skills.length)))"

核心能力

1. 需求对齐（Requirement Alignment）

深度理解用户意图
明确 Agent 核心能力和边界
确定技术栈和依赖关系

2. 架构设计（Architecture Design）

设计符合 gitagent 标准的目录结构
规划技能、工具、工作流
提供完整的架构文档

3. 文件生成（File Generation）

渐进式生成配置文件
转换技能为 Agent Skills 标准格式
创建 MCP 兼容的工具定义

4. 闭环验证（Verification Loop）

运行结构验证器
测试导出功能
提供改进建议

目录结构

agents/agent-construction-engineer/
├── agent.yaml                    # Agent 核心清单（spec_version 0.1.0）
├── SOUL.md                       # Agent 身份定义
├── RULES.md                      # 约束规则
├── DUTIES.md                     # 职责声明（maker/checker）
├── AGENTS.md                     # 子 Agent 关系与委托规则
├── README.md                     # 本文档
│
├── skills/                       # 技能模块（SKILL.md，name 须等于目录名）
│   ├── requirement-alignment/
│   ├── architecture-design/
│   ├── file-generation/
│   ├── verification-loop/
│   ├── openclaw-integration/
│   └── pi-agent-development/
│
├── tools/                        # 声明式工具（input_schema + implementation.script）
│   ├── structure-verifier.yaml
│   └── openclaw-plugin-verifier.yaml
│
├── workflows/                    # SkillFlow（steps 数组格式）
│   └── four-phase-workflow.yaml
│
├── hooks/                        # 生命周期钩子（7 个标准事件）
│   ├── hooks.yaml
│   └── scripts/
│
├── memory/                       # 持久化记忆
│   ├── MEMORY.md
│   ├── memory.yaml
│   └── archive/
│
├── knowledge/                    # 知识库（index.yaml 使用 entries 键）
│   ├── index.yaml
│   └── docs/
│
└── examples/                     # 校准示例（*.md）
    └── scenarios/

工作流

Agent Construction Engineer 采用四阶段共创工作流：

graph LR
    A[需求对齐] --> B[架构设计]
    B --> C[文件生成]
    C --> D[闭环验证]
    D --> E[完成]
    
    B -.用户审查.-> B
    C -.渐进确认.-> C

阶段 1：需求对齐

触发信号：用户描述新 Agent 需求或升级现有 Agent

输出：

需求文档
功能清单
技术栈选型

阶段 2：架构设计

触发信号：需求确认后

输出：

目录结构设计
技能/工具/工作流规划
架构文档

关键检查点：等待用户审查通过

阶段 3：文件生成

触发信号：架构审查通过后

输出：

agent.yaml
SOUL.md
RULES.md
技能文件（Agent Skills 格式）
工具定义（MCP 格式）

执行方式：渐进式生成，分批确认

阶段 4：闭环验证

触发信号：文件生成完成后

输出：

验证报告
测试结果
改进建议

技能系统

所有技能遵循 Agent Skills 开放标准，具备跨平台兼容性。

已实现技能

| 技能名称 | 描述 | 文件路径 | |---------|------|---------| | requirement-alignment | 需求对齐与分析 | skills/requirement-alignment/SKILL.md | | architecture-design | 架构设计与规划 | skills/architecture-design/SKILL.md | | file-generation | 文件生成与转换 | skills/file-generation/SKILL.md | | verification-loop | 闭环验证与测试 | skills/verification-loop/SKILL.md |

技能发现路径

技能按以下优先级加载与检索：

agents/skills-library/ （全局技能公共库 - 优先使用）
agents/agent-construction-engineer/skills/ （Agent 本地专属技能）
~/.agents/skills/ （用户全局生态）
Agent Skills 市场（SkillsMP）

工具系统

所有工具遵循 MCP（Model Context Protocol）标准，可与其他 MCP 兼容系统集成。

已实现工具

| 工具名称 | 描述 | 类型 | |---------|------|------| | structure-verifier | 验证目录结构完整性 | 验证器 | | openclaw-plugin-verifier | 验证 OpenClaw 插件配置 | 验证器 |

配置

模型偏好

model:
  preferred: claude-sonnet-4-5-20250929
  fallback:
    - claude-opus-4-6
  constraints:
    temperature: 0.2
    max_tokens: 8192

运行时参数

runtime:
  max_turns: 50
  timeout: 300

最佳实践

1. 保持核心文件精简

SOUL.md < 200 行
RULES.md < 150 行
详细知识存储在 knowledge/ 和 skills/

2. 使用标准命名

Agent 名称：kebab-case（agent-construction-engineer）
YAML 键：snake_case（spec_version）
目录名称：kebab-case（requirement-alignment）

3. 渐进式交付

先生成核心文件（agent.yaml + SOUL.md）
再生成扩展文件（技能、工具、工作流）
每批生成后等待用户确认

4. 强制验证

每次生成后运行 tools/structure-verifier.sh
确保所有引用的资源实际存在
测试加载功能是否正常

兼容性

模型 provider 支持

✅ anthropic（Claude）
✅ openai（GPT）
✅ google（Gemini）
✅ groq / xai / mistral / openrouter / deepseek 等

标准遵循

✅ gitagent spec 0.1.0（CLI 2.x）
✅ Agent Skills 开放标准
✅ MCP 客户端（mcp_servers）

贡献

欢迎贡献新的技能、工具或改进建议！

添加新技能

在 skills/ 下创建新目录
创建 SKILL.md 并添加 YAML frontmatter（name 等于目录名）
在 agent.yaml 的 skills 列表中注册
运行 tools/structure-verifier.sh 验证

添加新工具

在 tools/ 下创建 YAML 定义
包含 input_schema 和 implementation.script
提供实现脚本（相对 tools/ 目录）
运行 tools/structure-verifier.sh 验证

许可证

MIT License