Skip to content

linfen123456/agent-harness

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Agent Harness Blueprint

Current Status

Local MVP and Hardening skeleton work is complete enough for governed pilot preparation. TASK-021 has passed simulated/local-equivalent testing with test_level=SIMULATED_LOCAL_EQUIVALENT. The project is not production-complete until a real pilot project, real MCP startup verification, and remote CI evidence are provided.

Run the local completion gate before release decisions:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\harness\completion-readiness.ps1 -Command Check -Root .

Roadmap: docs/planning/phase-4-completion-roadmap.md.

这是一个企业级 Agent Harness 方案与落地模板仓库,目标是把 Agent 从 Demo 能力推进到可治理、可评估、可审计、可持续演进的企业级交付体系。

当前内容

  • 企业级 Agent Harness 总方案:docs/agent-harness-implementation-guide.md
  • 仓库级 Agent 操作指南:AGENTS.md
  • 分析、调研、需求、架构、执行、测试、运营文档:docs/
  • 项目级 Harness 模板:.harness/
  • MCP 注册与策略模板:.harness/mcp/
  • 轨迹评估与回归数据模板:.harness/evals/
  • AI 开发进度计划:docs/planning/ai-development-progress-plan.md
  • 当前执行任务计划:docs/planning/current-execution-plan.md

快速阅读路径

  1. 阅读 文档索引
  2. 阅读 Agent 操作指南
  3. 阅读 企业级总方案
  4. 阅读 执行计划
  5. 阅读 实施 Runbook
  6. 使用 .harness/ 模板初始化试点项目。

开发推进规则

任何后续任务开始前必须维护进度文档:

  • 总进度计划:docs/planning/ai-development-progress-plan.md
  • 当前执行计划:docs/planning/current-execution-plan.md

任务开始时:

  • 状态改为 In Progress
  • 写入开始时间
  • 写入当前执行记录

任务完成时:

  • 状态改为 Done
  • 写入完成时间
  • 写入产物路径和执行记录

阻塞时:

  • 状态改为 Blocked
  • 在当前执行计划中记录阻塞原因和解除条件

仓库结构

.
├── .harness/   # 项目级 Agent Harness 模板
├── docs/       # 企业级方案、设计、计划、测试、运营文档
├── scripts/    # 校验和自动化脚本
├── AGENTS.md   # 仓库级 AI Agent 操作指南
├── .gitignore
└── README.md

Next Steps

Current external completion blockers:

  1. Raise TASK-021 test degree from SIMULATED_LOCAL_EQUIVALENT to REAL_EXTERNAL by providing a real pilot project path, stack, build command, test command, owner, and any required package/network approvals.
  2. Run the local completion readiness gate and confirm the expected BLOCKED_EXTERNAL or READY_FOR_EXTERNAL_PILOT verdict.
  3. Execute the pilot onboarding checklist and archive one real low-risk end-to-end AI coding task.
  4. Enable remote CI and branch protection in the external repository before claiming release readiness.

About

Agent Harness 是一个面向企业级 AI Agent 开发治理的本地化框架与模板仓库,提供从需求分析、任务编排、工具权限、MCP 配置、审批流程、轨迹评估、成本记录到回归验证的完整治理骨架。当前项目已完成本地 MVP 与 Hardening 骨架,支持模拟试点验证、质量门禁和变更归档;真实外部试点、MCP 进程启动和远端 CI 可在获得项目与权限后继续接入。

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages