这是这个专栏的第一篇:讲清楚我们要解决什么问题、14 篇文章怎么读、以及它如何变成了一个开源框架
如果你正在用 Claude Code、Codex、Cursor 或任何 Coding Agent,你大概率已经发现:让它写出能跑的代码很容易,让它做出符合工程标准的交付很难。这个系列记录的就是解决这个难题的一整套方法——并且它已经落地为一个开源框架FlowMind(github.com/Eleven-M/flowmind)。
一、问题的起点:会写代码 ≠ 会做工程
2025 年之后,AI 编码 Agent 的代码能力已经不再是瓶颈。真正的瓶颈出现在代码之外:
| 你遇到的情况 | 背后缺失的东西 |
|---|---|
| AI 设计的方案和已有系统的约定对不上,返工三次 | 它没见过你的历史需求与项目规范 |
| 让它"看一下"代码,它顺手就改了,还 commit 了 | 没有读写权限边界 |
| 同一个错误这周纠正过,下周它又犯 | 没有记忆和沉淀机制 |
| 产出看着挺好,敢直接合进主干吗? | 没有质量门禁兜底 |
这些问题没法靠"换个更强的模型"解决——它们是工程问题,需要工程手段:资料管理、权限隔离、规范加载、流程编排、知识沉淀、质量门禁。这个系列就按这条线展开。
二、一个核心主张
先查事实、先定边界、先过规范,
再做设计,最后沉淀知识。
每一步都发生在 Agent 动手写代码之前或之后——唯独不在"写代码"这一步上较劲
传统 AI 编码的使用方式是"一句话需求 → 直接生成"。这个系列主张的流程是:
需求输入 │ ▼ ① 查事实 加载本地知识库、历史需求、已有设计(01、07 篇) │ ▼ ② 定边界 只读模式先行,写入需显式授权(02 篇) │ ▼ ③ 过规范 API/DB/Redis/Kafka/错误码规范强制加载(04 篇) │ ▼ ④ 做设计 OpenSpec:proposal → design → tasks → tests(03、05 篇) │ ▼ ⑤ 接资源 MCP 绑定 YApi/语雀/数据库/Redis/SLS(06 篇) │ ▼ ⑥ 过门禁 复杂度/分层/安全配置/测试检查(08 篇) │ ▼ ⑦ 沉淀 知识入库 + 学习反馈,下次直接复用(07、10 篇)
三、14 篇文章的路线图
整个系列分四段,每段解决一个阶段的问题。可以按顺序读,也可以按需跳读:
| 阶段 | 篇目 | 解决的问题 |
|---|---|---|
| 主线:需求 → 交付 → 沉淀 | 01–07 | 本地资料优先、读写隔离、OpenSpec 工作流、规范加载、多服务并行、MCP 资源绑定、知识沉淀闭环——完整的交付方法论 |
| 运营:质量与排障 | 08–10 | 交付前质量门禁、线上问题一条链路排查(SLS + DB/Redis 验证)、学习反馈让 Agent 越用越聪明 |
| 架构:底层设计 | 11–13 | SKILL.md 的标准结构与触发词设计、MCP 安全资源连接器、从单技能到技能编排与自动路由 |
| 收官:开源 | 14 | 整套方法论的工程化落地——FlowMind 框架正式开源,31 个内置技能 + 学习引擎 + 质量门禁 |
四、这个专栏适合谁
| 如果你是…… | 建议的读法 |
|---|---|
| 天天用 Coding Agent 的一线开发 | 从 01、02 读起——资料优先和读写隔离能立刻改善日常体验 |
| 带团队的技术负责人 | 重点读 03、05、08——流程化与质量门禁决定敢不敢让团队大规模用 |
| 做AI 工具/平台方向的工程师 | 直接看 11–13 的架构三篇 + 14 的开源实现,源码可读 |
| 刚接触 AI 编码的新同学 | 按 00 → 01 → 02 → 03 顺序读,前四篇是方法论的地基 |
五、方法论与框架的关系
一句话说清楚:前 13 篇是"为什么这么做",第 14 篇是"拿来就能用"。
系列里的每个设计——本地资料优先、只读/可写隔离、OpenSpec 流程、MCP 绑定、学习反馈——都没有停留在文章里,而是被实现成了 FlowMind 框架里的具体模块(31 个内置技能、三入口 CLI、MCP Server、459 项 CI 测试)。文章负责讲清设计权衡,框架负责让你零成本上手:
git clone https://github.com/Eleven-M/flowmind.git cd flowmind && npm install && npm run build ./bin/flowmind.js doctor flowmind demo log-audit # 不配任何 key,直接看效果
六、写在出发前
这个系列不鼓吹"AI 替代程序员",也不教"提示词玄学"。它只回答一个务实的问题:当 AI 的代码能力已经够用时,工程师的价值往哪里放?答案是——定义事实、划定边界、制定规范、设计流程、沉淀知识。这些恰恰是 AI 做不了、而工程方法可以交给 AI 执行的。
专栏目录会持续更新,点个收藏不迷路。下一篇文章,我们从一切的起点讲起:《我给 AI 编码 Agent 加了一条"本地资料优先",终于敢让它做需求设计了》。
专栏配套开源项目
https://github.com/Eleven-M/flowmind
MIT 协议 · 31 个内置技能 · CI 459 项测试 · 中英双语文档
说明:文中涉及的框架数据(31 个内置技能、459 项 CI 测试等)为发稿当日实测值,可在 GitHub 仓库 Actions 页面直接验证。本文为技术分享,不构成任何投资或商业建议。