AI Agent 技术方案可行性分析：26 个应用案例与选型参考

# .gitlab-ci.yml
codex-quality:
  stage: test
  image: node:24
  variables:
    CODEX_API_KEY: ***
  before_script:
    - npm install -g @openai/codex
  script:
    - |
      set -euo pipefail
      # 生成文件白名单，限制 Codex 只读取真实存在的文件
      FILE_LIST=$(git ls-files | head -500)
      # 运行 Codex，使用只读沙箱模式
      codex exec \
        --sandbox read-only \
        --model gpt-5.4-mini \
        --output-format json \
        "Audit this codebase for security vulnerabilities, code smells, and architecture violations. Return findings in CodeClimate format."

# 在 GitLab CI 中
codex-remediate:
  stage: test
  image: node:24
  script:
    - |
      # 获取 SAST 扫描结果
      gl-sast-report.json
      
      # 将 SAST 报告传给 Codex，让它生成修复补丁
      codex exec \
        --sandbox workspace-write \
        --model gpt-5.4 \
        --append-system-prompt "You are a security engineer. Review the SAST findings and produce minimal, targeted fixes. Do not refactor unrelated code." \
        "Fix these security vulnerabilities: $(cat gl-sast-report.json)"

# 使用 codex exec 的结构化输出模式
CODEX_API_KEY="***" codex exec \
  --ephemeral \
  --ignore-user-config \
  --sandbox read-only \
  --output-schema .codex/schemas/dependency-audit.json \
  "Audit all npm dependencies for known CVEs. Return structured JSON with severity, CVE ID, affected package, and recommended fix version."

# AGENTS.md
## Build & Test
- Build: `npm run build`
- Test: `npm run test`
- Single test: `npm test -- --testPathPattern=<file>`

## Development Policy
- **All new features and bug fixes MUST use test-driven development**
- Write the failing test FIRST, confirm it fails, then implement
- Never write production code without a corresponding failing test
- Run the full test suite after every implementation change
- Target 80%+ line coverage on new code

阶段1 (RED)：Test Writer 子 Agent → 写出失败的测试
阶段2 (GREEN)：Implementer 子 Agent → 只看到测试文件，实现最小功能
阶段3 (REFACTOR)：Refactorer 子 Agent → 在保持测试通过的前提下重构

# 1. 初始化 Git 仓库（Codex 依赖 Git worktree 做隔离）
mkdir rest-api-demo && cd rest-api-demo
git init

# 2. 启动 Codex 的 Plan 模式
codex --plan

# 3. 提交结构化初始化指令
"Initialize a production-grade REST API for book collection management.
Technical requirements:
- Framework: Express.js 4.19+
- Database: PostgreSQL via pg package
- Validation: express-validator 7.x
- Security: helmet 7.x, cors 2.8.x, express-rate-limit 7.x
- Testing: Jest 29.x, supertest 6.x
- Logging: morgan (dev mode only)
- ESLint with Airbnb config
- .env.example with database credentials template
Do not include: frontend frameworks, GraphQL, authentication (out of scope)"

CodeBuddy Agent Loop:
├─ 分析现有代码库结构
├─ 选择合适的子 Agent（architect → coder → tester → reviewer）
├─ 生成计划并等待确认
├─ 执行文件修改（AST 感知的编辑）
├─ 运行测试验证
└─ 生成 diff 供审查

# packages/api/CODEBUDDY.md
## API Package Conventions
- All API routes must use the standard error response wrapper
- Database queries must use the repository pattern from `src/repo/`
- Never import from `src/internal/` outside this directory

// .codebuddy/settings.json
{
  "worktree": {
    "sparsePaths": [
      ".codebuddy/",
      "packages/api/",
      "packages/shared/"
    ]
  },
  "additionalDirectories": ["packages/shared/"]
}

"Update the shared User type from `packages/shared/types.ts` 
 and update all call sites in `packages/api/`. 
 The new type should add `emailVerified: boolean` field."

# 创建一个包含 5 个 Agent 的团队
"Generate 5 members to investigate different hypotheses about 
 why the app disconnects after sending a single message. 
 Have them discuss with each other, trying to disprove each other's 
 theories like a scientific debate. Update the final consensus into 
 the troubleshooting document."

Team Lead（协调者）
  ├─ Member 1: 安全视角 → 检查认证 Token 过期逻辑
  ├─ Member 2: 网络视角 → 检查 WebSocket 心跳配置
  ├─ Member 3: 数据库视角 → 检查连接池配置
  ├─ Member 4: 应用逻辑视角 → 检查消息处理队列
  └─ Member 5: 基础设施视角 → 检查负载均衡和超时设置

每个 Member:
  - 独立的上下文窗口
  - 独立的终端会话
  - 通过 Mailbox 系统互相通信
  - 自动认领任务列表中的下一个任务

Lead 汇总所有发现 → 生成最终排查文档

// .codebuddy/automations.json
{
  "automations": [
    {
      "name": "Daily Standup",
      "schedule": "0 8 * * *",
      "prompt": "Generate a standup report from recent activity: list completed tasks, in-progress items, and blockers. Reference connected Jira tickets and GitHub PRs."
    },
    {
      "name": "Code Health Check",
      "schedule": "0 9 * * *",
      "prompt": "Scan the codebase for: TODOs/FIXMEs, files over 500 lines, change hotspots (files with most commits in last 30 days), and stale index indicators."
    },
    {
      "name": "Dependency Audit",
      "schedule": "0 11 * * *",
      "prompt": "Audit package.json for wildcard version ranges, deprecated packages, and known vulnerabilities. Generate a prioritized update list."
    },
    {
      "name": "Git Watchdog",
      "schedule": "0 */2 * * *",
      "prompt": "Check for uncommitted changes that have been sitting for over 2 hours. Alert if found."
    }
  ]
}

# 使用内置的 /deep-research 工作流
/deep-research "Audit API contracts across all packages in this monorepo"

# 或使用 ultracode 模式让 CodeBuddy 自动决定使用 Workflow
/effort ultracode
"Check authentication mechanisms across the entire codebase"

Dynamic Workflow Script（CodeBuddy 自动生成的 JS 编排脚本）
├─ Phase 1: 并行探索
│   ├─ Agent A: 扫描 packages/api/ 的路由定义
│   ├─ Agent B: 扫描 packages/web/ 的 API 调用
│   └─ Agent C: 扫描 packages/shared/ 的类型定义
├─ Phase 2: 交叉验证
│   ├─ Agent D 验证 Agent A 的发现（对抗性审查）
│   ├─ Agent E 验证 Agent B 的发现
│   └─ Agent F 验证 Agent C 的发现
└─ Phase 3: 汇总报告
    └─ Lead Agent 生成审计报告

1. 创建 Goal
   "实现一个实时协作编辑器，包括：
    - WebSocket 连接管理
    - OT（Operational Transformation）算法
    - 光标位置同步
    - 在线用户列表
    - 冲突解决机制"

2. ZCode 自动分解为子任务
   ├─ 子任务 1: 项目架构与依赖配置
   ├─ 子任务 2: WebSocket 服务端实现
   ├─ 子任务 3: OT 算法核心逻辑
   ├─ 子任务 4: 前端渲染与光标同步
   ├─ 子任务 5: 单元测试与集成测试
   └─ 子任务 6: 部署与文档

3. 每个 Checkpoint
   - 暂停并展示修改的 diff
   - 等待开发者审查和批准
   - 继续执行下一个子任务

4. 跨会话持久化
   - 关闭应用后，Goal 状态保存
   - 重新打开后从上次中断处继续
   - 通过微信/Telegram 远程查看进度

# 在手机微信中向 ZCode Bot 发送消息
"查看当前 Goal 的进度"
→ ZCode 返回：已完成 4/6 子任务，当前正在实现 OT 算法

"批准当前 checkpoint"
→ ZCode 继续执行下一个子任务

"暂停任务，我需要思考一下架构方案"
→ ZCode 暂停执行，等待后续指令

1. 本地配置
   - 在 ZCode 中配置 SSH 连接（远程服务器地址、密钥）
   - 选择要操作的远程项目目录

2. 远程执行
   "在远程服务器的 /opt/ml-service 项目中，
    添加模型版本管理功能，包括：
    - 版本注册 API
    - 模型文件存储（使用 MinIO）
    - 版本回滚机制"

3. 远程执行流程
   ├─ ZCode 通过 SSH 在远程服务器上创建隔离工作区
   ├─ 在远程环境中执行所有编码操作
   ├─ 远程运行测试验证
   └─ 将结果和 diff 返回本地

4. 优势
   - 不需要在本地复制大型模型文件
   - 利用远程 GPU 资源进行测试
   - 通过手机微信远程监控进度

# 在 ZCode 中一键安装
"安装 Claude Code, Codex CLI, 和 OpenCode"

# ZCode 自动执行：
1. 检测操作系统和包管理器
2. 安装 Node.js（如需要）
3. npm install -g @anthropic-ai/claude-code
4. npm install -g @openai/codex
5. npm install -g opencode-ai
6. 配置各工具的 API 密钥
7. 验证安装

# 耗时：从数小时缩短到数分钟

GLM Coding Plan 层级：

Lite ($12.60/月)
├─ GLM-5.3-Flash: 快速代码补全和简单修改
└─ 适合：日常小改动、代码格式化、简单 bug 修复

Pro ($56/月) 
├─ GLM-5.3: 标准编码任务
├─ 6× Lite 额度
└─ 适合：中型项目开发、功能实现

Max ($117.6/月)
├─ GLM-5.2: 复杂架构设计和长时任务
├─ 14× Lite 额度
├─ 专用峰值资源
└─ 适合：大规模重构、跨文件功能开发

空闲时段任务：
- 非紧急任务排队，在空闲时段免费执行
- 不消耗计划额度

# ~/.openclaw/openclaw.json
{
  "skills": [
    {
      "name": "morning-briefing",
      "schedule": "0 7 * * *",
      "prompt": "Generate a morning briefing including:
        1. Today's calendar events (from Google Calendar)
        2. Unread important emails (from Gmail)
        3. Top 5 tech news headlines
        4. Today's weather
        Send the result as a formatted message to my WhatsApp."
    }
  ]
}

07:00 触发 → 拉取日历事件 → 拉取邮件 → 搜索新闻 → 调用天气 API 
→ 汇总生成简报 → 通过 WhatsApp 发送 → 完成

{
  "skills": [
    {
      "name": "email-triage",
      "schedule": "*/30 * * * *",
      "prompt": "Check unread emails in the last 30 minutes. For each email:
        1. Classify as: URGENT (requires immediate attention), 
           ACTIONABLE (needs response/action), 
           FYI (information only), SPAM
        2. For URGENT and ACTIONABLE: draft a reply
        3. Save drafts to the Drafts folder
        4. Send a summary to my Telegram with counts and highlights"
    }
  ]
}

{
  "skills": [
    {
      "name": "pr-watchdog",
      "schedule": "0 */2 * * *",
      "prompt": "Check all open PRs in my repositories. For each PR:
        1. Check if CI is passing
        2. Check for security issues using CodeQL
        3. Check if the PR has been open for more than 48 hours without review
        4. For failing CI: analyze the failure and suggest fixes
        5. For stale PRs: send a reminder to the PR author
        Send a summary to Discord #dev channel"
    }
  ]
}

阶段 1: 选题研究
  "Research the topic 'VPS backup strategies for 2026' for a tutorial.
   Find the top 10 ranking articles, list their URLs, and summarize 
   what each one covers. Flag any content farms."

阶段 2: 大纲起草
  "Based on the research, create a detailed tutorial outline with:
   - Target audience
   - Learning objectives
   - Section headings
   - Key code examples needed"

阶段 3: 内容撰写
  "Write the full tutorial based on the outline. Include:
   - Introduction and prerequisites
   - Step-by-step instructions
   - Code examples with explanations
   - Troubleshooting section"

阶段 4: 多平台发布
  "Publish the tutorial to:
   - Medium (full article)
   - Twitter/X (thread summary)
   - LinkedIn (professional summary)
   - Save as Markdown for future updates"

场景 1：离家模式
  "Goodbye" → 关闭所有灯 → 调低恒温器 → 锁门 → 启动安防摄像头 → 发送确认

场景 2：回家模式  
  "I'm home" → 打开客厅灯 → 调高恒温器 → 播放音乐 → 检查是否有包裹送达

场景 3：睡眠模式
  "Good night" → 关闭所有灯 → 设定安防 → 调低恒温器 → 启动夜灯 → 发送确认

会话 A: "实现用户认证功能，使用 JWT"
→ Hermes 记录：使用了 JWT、创建了 auth.ts、测试了登录流程

会话 B（一周后）: "继续完善认证功能，添加刷新 Token"
→ Hermes 自动检索上次的上下文，无需重新解释

├─ 调度实验在 Modal/Daytona 无服务器后端运行
├─ 跟踪每次实验的结果
├─ 分析哪些参数组合表现最好
├─ 建议下一轮实验方向
└─ 生成实验报告

├─ 导出轨迹 → 用于 RL 训练
├─ 更新模型 → 部署到 Hermes
└─ 评估改进 → 重复

# 使用 Hermes 的模型路由功能
from hermes_tools import execute_code

result = execute_code("""
# 配置多模型路由策略
config = {
    "routing": {
        "simple_tasks": {
            "model": "gpt-5.4-mini",
            "criteria": ["single_file_edit", "simple_query", "format_conversion"]
        },
        "medium_tasks": {
            "model": "gpt-5.4",
            "criteria": ["multi_file_edit", "debugging", "refactoring"]
        },
        "complex_tasks": {
            "model": "claude-sonnet-4",
            "criteria": ["architecture_design", "security_review", "complex_debugging"]
        }
    },
    "fallback": {
        "primary": "openai",
        "backup": "anthropic",
        "local": "ollama"
    }
}
""")

# AGENTS.md - 通用模板

## 项目概述
- 项目名称和用途
- 技术栈清单

## 构建与测试
- 构建命令
- 测试命令
- Lint 命令

## 代码规范
- 格式化工具
- 命名约定
- 架构模式

## 安全策略
- 禁止的操作（如 `rm -rf /`、`sudo`）
- 敏感文件路径
- 网络访问限制

## 特定约定
- 文件组织方式
- API 设计风格
- 数据库访问模式

典型 MCP 服务器：
├─ GitHub MCP: 仓库操作、PR 管理、Issue 追踪
├─ Jira MCP: 工单管理、Sprint 规划
├─ Database MCP: 数据库查询、Schema 检查
├─ Playwright MCP: 浏览器自动化
├─ Sentry MCP: 错误追踪和监控
└─ 自定义 MCP: 企业内部系统集成