不会还有人每个会话都从零发明流程吧？入口文件才是值班手册 | Agent 启动清单

系列《从 Rule 到落地AI 工程化实践》第 16 篇标签Agent · 入口文件 · 执行纪律 · 清单专栏从小白到AI落地大师序言工具接上了童鞋们发现另一个飘每个会话从零发明流程有时忘加载安全 Rule有时结束不写验证。本篇定义 Agent 入口文件应包含的启动清单与执行纪律让每次会话行为稳定可预期。说句自嘲的我当过「即兴值班长」——临场发挥很帅复盘很惨。后来肯把入口文件当值班手册版本管理翻车率才下降。帅不是目标可预期才是。概念Agent按入口手册启动与收尾的编排者。启动清单加载常驻 Rule、确认目标、扫描高风险路径。执行纪律小步改动、高风险确认、结束前自检。停靠点必须暂停确认或跑验证的检查点。可以理解为入口文件是航班起飞前检查单。再资深的机长也不靠记忆跳过燃油与舱门确认。助手更不该靠气质起飞。问题在哪没有入口文件时流程随会话心情漂移。有人先改代码再想目标有人改完不跑验证有人碰生产工具不确认。Skill 与 MCP 明明准备好了却在入口处断开——像装备齐全但不出门。出口也常缺约定改了什么、怎么验、剩余风险。人和 CI 无法接力记忆层也捕获不到干净原料。举例入口文件骨架虚构 acme# Agent入口acme ## 启动 1. 加载安全Rule 2. 询问/确认本会话目标 3. 扫描是否命中高风险路径 ## 执行 - 不一次改多个无关模块 - 涉及映射变更走fix-parse Skill ## 结束 - 列出文件变更与验证命令停靠点配置示意checkpoints:-before_prod_tool:confirm-after_patch:run_unit_or_fixtures-before_finish:write_summary与 Skill、MCP 的衔接句写进入口何时必须加载某 Skill何时禁止直接撞生产工具。入口文件也要版本管理变更写 changelog——纪律本身也需要纪律。自检# 入口文件自检 - [ ] 是否有启动清单而非即兴发挥 - [ ] 是否有执行中停靠点 - [ ] 结束是否约定输出变更与验证 - [ ] 是否写明与 Skill/MCP 的衔接 - [ ] 入口文件是否进版本库两问。第一新会话第一分钟助手是否必然加载安全 Rule不是必然清单就还是愿望。第二结束时能否让另一个人只看总结接下去不能出口约定还没生效。入口文件保持短。超过两屏人就不读模型也容易丢。细节链到 Skill入口只留纪律与停靠点。把「确认目标」写成强制步。目标不清就开改是最常见的忙乱来源——看起来勤奋实际在挖坑。入口文件BOOT.md建议固定五段角色与目标、必读 Rule/Pack 版本、可用 command 列表、停靠点何时问人、禁止事项。会话开始先读它比每次从聊天记录考古靠谱。和流水线的关系BOOT 负责「上班打卡与今日菜单」第 11 篇流水线负责「点菜之后怎么过门禁、谁上灶、怎么归档」。两张纸缺一值班就会靠默契。启动清单要可勾选不要写成散文诗。例如已加载 Packacme-rules1.4.x已读 hard-constraints今日任务风险级已声明高危命令确认人是谁值班交接只传 BOOT 勾选结果 correlation_id不传三千行聊天。聊天是噪声勾选是状态。读到这里不妨立刻做一个五分钟动作打开你们仓库找到与本篇对应的那个目录没有就新建把文中最小示意落成真实文件名。文件在讨论才有坐标文件不在下周还会从「我们觉得」开始。第 16 篇的验收不是「读完」是「仓库里多了一份可指出的东西」。举例加长BOOT 里的停靠点示例改adaptor/public之前必须停风险 T3 及以上必须停加载的 Pack 版本与 lock 不一致必须停停靠点是值班友谊的保险绳不是不信任。BOOT.md还可以加一段「禁止即兴」## 禁止 - 未加载 Pack 版本号就改生产相关文件 - 跳过确认板执行 T3 - 无 correlation_id 开始多步骤任务入口文件的语气可以温柔红线必须硬。温柔而不硬值班夜会变成即兴戏剧。思考小结三句。入口文件是 Agent 的值班手册。启动清单降低漏加载 Rule 的概率。结束输出约定便于人和 CI 接力。可以理解为起飞检查单写好了再谈多机长协作。下篇扩展多角色主 Agent、子任务与审核门禁——别既当运动员又当裁判。下篇预告《多角色协作主 Agent / 子任务 / 审核门禁》——分角色是为了责任清晰不是为了堆模型调用。觉得有用的话欢迎点赞、留言贴一版你的入口骨架有「即兴值班长翻车」经历也欢迎对照清单拆。专栏从小白到AI落地大师《从 Rule 到落地AI 工程化实践》