Skip to content
View heweidong-ecco's full-sized avatar

Block or report heweidong-ecco

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
heweidong-ecco/README.md

AI Agent 工程

一条主线:给「AI 写出来的东西」加外部约束与反馈。

代码由 AI 协同产出。所以问题不在"模型更强",在"约束更硬" —— 把「靠人记得住」变成「机器拦得住」。

External constraints and feedback for AI-generated work — turning "hoping people remember" into "machines that block".

10 个已完成的 AI 工程项目 · 全部可点开 · 每条都注明边界与未验证项(不假装全绿)


从哪儿开始

如果只想看三个:agent-eval-gate(一道上线评测门,抓到过只有外部门能发现的缺陷)· agent-pitfalls-kb(唯一读者是 Agent 的规则库)· fastapi-rag-agent(最完整的生产级件)。 详情都在下面。


约束与治理 · Constraint & Governance

本机 agent-harness-engineering/

仓库 一句话
ai-delivery-harness-engineering AI 代码交付的治理层:规则 + 十阶段流水线 + 可程序化质量门禁 + 三道防编造闸。make gate 一次 15 步 · 137 测试 · 84% 覆盖 · 17 个可独立复用的门禁脚本。
🔻 已封存:它是容器不是内容 —— 缺可填充的真实来源,十阶段从未被真实需求走过(填充 0%)。
skills-workflow 把 Agent 的「提醒式」约束改造成硬约束:CLAUDE.md 173 行 → 34 行 · 关键约束下沉到 PreToolUse hook + permissions.deny。
抗绕过用例 1/5 → 5/5,且别人能自己跑(tests/07-bypass-resistance.sh)。
🔻 实测中查出这道门本身是坏的(三层静默失效),修复后才是 5/5。

可运行的项目 · Runnable Projects

本机 agent-projects/projects/

仓库 一句话
fastapi-rag-agent 单 Agent + LangGraph(不上多 Agent);Agent loop 不参与业务循环(理由:系统整体稳定性)。
混合检索 BM25 + 向量 + RRF 融合(只看排名、不吃分数 —— 两路量纲不同)· NLP 数据对齐(中英 / 全角半角)· 查询改写两套方案比过(本地 LoRA vs 云端 API)。
10,019 行 · 全面复审修掉 24 个问题(最危险的一类是静默)。
🔻 边界三条:是三版删减后的版本 · 重排序模块未并入本仓全量链路 · README 里的 P99<800ms 是目标不是实测。
ess-ai-sales-system 从一句业务描述拆出可执行的系统设计(需求基线 → 系统总纲 → 5 份决策记录)。
每条决策都是「选 A 不选 B」且可追溯 —— 外部调研 21 来源 / 40 claim,对抗核验后剔除了 4 条。
🔻 全部是 DEMO · 虚构厂商。
memory-system 分层记忆系统的架构:多租户 · 6 类存储 · 5 层检索 · 程序性记忆自进化。
Append-Only 用数据库触发器强制 —— 有测试证明 UPDATE / DELETE 真被拒绝(26 个用例)。

评测与数据 · Evaluation & Data

本机 agent-projects/eval-gate/ · agent-projects/lora-data/

仓库 一句话
agent-eval-gate 判分链路五段:schema 校验 → 调被测 → 确定性规则 → 大模型判分 → 阈值 → 输出退出码。
对外接口用退出码不用「提示」:0 放行 / 1 阻断 / 2 人工复核 / 3 运行错误 —— 「跑不出来」和「跑出来合格」是两件事。
门自己必须可复现地被验证:喂劣化输入 → 必须 exit 1。
基线四轮 0.75 → 0.975 · 12,305 行 · 覆盖率 94.57%。
🔻 边界:判别力仍标定不出(16 轮 A/B 两臂全 1.0);有一道门标成「硬」后主动降级为「半硬」 —— 诚实标强度优先于把门做硬。
lora-finetune LoRA 微调的数据与实验库 —— 数据集 · 训练配置 · 实验记录 · 评测结果集中存放。
许可:代码 MIT / 数据 CC BY-NC 4.0(⛔ 非商用)。

知识库 · Knowledge Base

本机 agent-facing/(直接给 Agent 读)· agent-facing-human/(对象是 Agent,人也参与)

仓库 一句话
agent-pitfalls-kb 给 Agent 读的可执行规则库。只收严重问题:不报错、不变红,却能让错的结论被当成正确结论交付。
每篇必备五节,第 5 节是「怎么验证它被落地」 —— 判据:「如果这条被违反了,有没有任何东西会变红或出声?」答「没有」⇒ 它还没落地。
⭐ 库自己被实测打过两次脸,两次都写进了库(一篇里七条规则只有 1 条是真门;一道门标着「已装」却挡不住)。
4,257 行 · 结构 = 四道门 + 门自己有防腐。
claude-agent-skills Agent Skills 的开发与维护仓:从需求记录到可加载的 SKILL.md —— 含设计过程、迭代留痕与验证证据。

工具与 Kit · Toolkits

本机 agent-projects/kit/ · agent-projects/fde/

仓库 一句话
ai-field-delivery-toolkit 模块化、离线优先的 AI 现场交付工具包(FDE):需求诊断 → 数据准备 → 原型组装 → 交付加固 → 监控 → 数据飞轮。
🔻 半成品 · 已停更。
🔒 Agent 开发 Kit 一个用来自动开新 Agent 项目的脚手架(private)。

其他 · Others

仓库 一句话
🔒 项目级 Agent 约束系统 约束系统设计(private · 设计阶段)。
🔒 设置与方案 Agent 的配置与纪律方案集(private)。

上表 3 行带 🔒 的:只给描述、不给仓名(它们是 private 仓)。


关于这份清单

  • 分类靠 GitHub Topics:每个仓都带 agent-harness-engineering / agent-projects / agent-facing / agent-facing-human,点 topic 即可筛同类
  • 🔻 表示边界 —— 每条都如实标注了未验证 / 已封存 / 未并入的部分。不假装全绿是这套工程的默认纪律。
  • ⚠️ 有一道门标着「硬」,实测后发现它其实只是「半硬」,已降级重标。

Popular repositories Loading

  1. memory-system memory-system Public

    多租户分层记忆系统架构:6 类存储 · 5 层检索 · 程序性记忆自进化。Append-Only 由数据库触发器强制 —— 有测试证明 UPDATE/DELETE 真被拒绝。Layered memory architecture for multi-tenant AI agents.

    Python

  2. ai-field-delivery-toolkit ai-field-delivery-toolkit Public

    Modular, offline-first delivery toolkit for AI field-deployment engineers (FDE): Covers requirement diagnosis → data-prep pipeline → prototype assembly → deployment hardening → monitoring → data fl…

    Python

  3. ess-ai-sales-system ess-ai-sales-system Public

    AI marketing & sales digitalization system for an overseas C&I ESS (commercial & industrial energy storage) exporter — requirements-driven product ▎ development with superpowers workflow. Closed lo…

    Python

  4. agent-eval-gate agent-eval-gate Public

    A production-readiness eval gate for AI agents — exit codes, not hints. 判分链路五段 → 退出码 0放行 / 1阻断 / 2人工复核 / 3运行错误;抓到过只有外部独立门能发现的生产缺陷。

    Python

  5. ai-delivery-harness-engineering ai-delivery-harness-engineering Public archive

    Archived reference kit for AI-delivery discipline: rules, a 10-stage pipeline, 5 human checkpoints, programmable quality gates, and 3 anti-fabrication gates. Built for brownfield projects; the gate…

    Python

  6. agent-pitfalls-kb agent-pitfalls-kb Public

    AI Agent 避坑库:给 Agent 读的可执行规则库,只收严重的 Agent/harness/AI 系统性问题。分区分篇、篇内编号、零项目路径依赖。Rules an AI agent can act on — severe pitfalls of agent/harness/AI systems.

    Python