Vibe Coding新型编程方式讲解_第1页
Vibe Coding新型编程方式讲解_第2页
Vibe Coding新型编程方式讲解_第3页
Vibe Coding新型编程方式讲解_第4页
Vibe Coding新型编程方式讲解_第5页
已阅读5页,还剩49页未读, 继续免费阅读

下载本文档

版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领

文档简介

Vibe

Coding新型编程方式讲解PromptEng.▸ContextEng.▸HarnessEng.开场·主线2今天要回答的三个问题90分钟·一条主线·三段演进Q1Chat与Agent差在哪?■单轮vs循环■被动vs主动规划■无工具vsShell/API/浏览器■无状态vs持久记忆Q2一个Agent为什么能可靠干活?■ReAct+AgentLoop■ETCLOVG七层框架■Skill/MCP/CLI三支柱■文档才是唯一真相来源Q3我作为学生怎么用起来?■六份规范文档+CLAUDE.md■95%信心审问法■Gitworktree并行开发■ClaudeCode五阶段方案PromptEng.▸ContextEng.▸HarnessEng.开场·主线3一条主线:Agent工程的三次迁移出自《AgentHarnessEngineering:ASurvey》(CMU/Yale/JHU/Amazon)PromptEngineering2022-2023"怎么跟模型说话"systemprompt·few-shot·单次性ContextEngineering2024-2025"模型该看见什么"窗口管理·记忆·压缩·SubagentHarnessEngineering2025-2026"怎么让模型可靠干活"工具接口·执行环境·验证·治理"PromptEngineering是把模型叫醒。ContextEngineering是让模型看见正确的信息。HarnessEngineering是让模型在真实世界里可靠行动。"https://lzhu.me/assets/slides/202606-advancing-agent-loops-with-humanize.pdfhttps://lzhu.me/assets/slides/202606-advancing-agent-loops-with-humanize.pdfPromptEng.▸ContextEng.▸HarnessEng.PromptEngineering·2022-20236§1.1从Chat到Agent的范式跃迁Chat是"一问一答";Agent是"目标驱动的自主行动闭环"维度ChatAgent模式单轮对话多轮循环(Loop)主动性被动响应主动规划与执行工具使用无文件、Shell、API、浏览器…记忆上下文窗口持久记忆+会话记忆+Skill沉淀状态无状态有状态,跨会话持久化GoogleCloud官方定义:AI智能体是使用AI来实现目标并代表用户完成任务的软件系统,表现出推理、规划和记忆能力,具有一定的自主性。PromptEng.▸ContextEng.▸HarnessEng.PromptEngineering·2022-20237一个把"Agent"讲透的例子:OpenAICodexGoals"普通prompt是一次性;Goals是一个持久目标"普通Prompt(一次性)■你说做什么,模型做完就停■每一轮都要重申目的■不记得整体上下文■不会自己检查进度■不会自己决定"下一步做什么"CodexGoals(持久目标)■目标不变,Codex自主推进■自己检查进度、决定下一步■在预算内持续迭代■典型:让它复现一篇论文的每个结论■每个结论标注:证据·状态·剩余不确定性从Prompt到Goals,就是从"提问"到"托管"——Agent心智模式的分水岭。PromptEng.▸ContextEng.▸HarnessEng.PromptEngineering·2022-20238§1.2Agent的核心引擎:ReActReasoning+Acting,Yaoetal.,20221推理ReasoningLLM分析当前任务状态,决定下一步行动2执行Acting根据推理执行操作:FunctionCall/MCP/Shell/代码3观察Observation观察结果,反馈到下一轮;或判断目标达成则输出工程实现的本质:一个While循环。每次迭代=一次LLM推理+工具调用+上下文处理。whilenotdone:thought=llm.reason(context)#推理action=llm.plan_action(thought)#决定动作obs=tools.execute(action)#执行context.append(thought,action,obs)#观察done=llm.check_goal(context)PromptEng.▸ContextEng.▸HarnessEng.PromptEngineering·2022-20239AgentLoop——工程上的完整闭环记忆·上下文·工具选择·观察·反思,都在这个循环里发生classAgent:def__init__(self,model,tools,memory):self.model=model#LLM推理引擎self.tools=tools#Function/MCP/CLI工具集self.memory=memory#长期记忆+会话记忆

defrun(self,goal,max_steps=50):ctx=self.memory.load(goal)forstepinrange(max_steps):plan=self.model.reason(ctx,goal)#Reasoningifplan.finish:returnplan.answeraction=self.tools.select(plan.tool_call)#Actingresult=action.execute()#Observationctx=self.memory.update(ctx,plan,action,result)ifplan.needs_reflection:ctx=self.model.reflect(ctx)#反思(可选)raiseTimeoutError("agentbudgetexhausted")PromptEng.▸ContextEng.▸HarnessEng.PromptEngineering·2022-202310两种重要的衍生模式Plan-and-Execute·Reflection——都是在ReAct骨架上加东西Plan-and-Execute■先做完整规划:把大任务拆成N个小步骤■再按步骤执行:每一步只关注局部问题■优点:长链路稳定,避免走一步看一步的漂移■缺点:一旦环境变化,计划要重新出■典型:ClaudeCode的PlanMode(Shift+Tab)■典型:LangGraph的StateGraphReflection■在ReAct基础上加"反思"环节■每次失败后把经验写入记忆缓冲区■下次遇到类似问题时先查经验再决策■优点:越用越聪明,能吸取教训■典型:Reflexion论文的自我反思循环■典型:lessons.md就是它的工程实现PromptEng.▸ContextEng.▸HarnessEng.PromptEngineering·2022-202311PromptEngineering时代:做法与局限"怎么跟模型说话"的手艺,仍是基础,但已远远不够当年最重要的三件事■SystemPrompt:定人设、定风格、定outputschema■Few-Shot:把3-5个高质量样例塞进上下文■Chain-of-Thought:让模型"一步一步想"■各种XML/Markdown结构化提示词■手工微调temperature/top_p为什么单靠Prompt不够■一次性:对话结束记忆归零■窗口有限:塞不下真实项目的上下文■不可复用:换个人写就换个效果■无法验证:模型说得头头是道也可能全错■无法执行:说"我会帮你部署"其实动不了手■→引出Context与Harness两次范式扩展PromptEng.▸ContextEng.▸HarnessEng.PromptEngineering·2022-202312Part1小结:从"叫醒模型"到"喂对信息"主线推进:PromptEngineering→ContextEngineeringPromptEng.决定"模型愿不愿意说";但要"说得对,且能做到",靠的是Context+Harness。课堂发现:很多同学抱怨"模型变笨了"——其实是喂给它的上下文腐了。下一部分讲怎么解。已经解锁的能力■会写清晰的systemprompt■会用few-shot拉齐输出格式■会用ReAct+PlanMode拆任务■理解Chat与Agent的本质差异还没解决的痛点■一个session越用越傻(ContextRot)■一到复杂项目AI就开始"编造需求"■换个session就要重新交代一切■"给建议vs直接干活"仍有鸿沟PromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202513§1.3ContextEngineering定义来源:《AgentHarnessEngineering:ASurvey》CMU/Yale/JHU/Amazon"模型该看见什么"哪些信息该进上下文,哪些要压缩,窗口满了怎么办,会话之间怎么传递——这些工程决策的总和。■不是"prompt写得更花哨",而是"送进去的信息更相关"■把外部世界(文档/代码/日志/记忆)压缩为窗口能吃下的高信噪比切片■决定"哪些主动喂进去,哪些让Agent按需拉取,哪些丢掉"■与检索(RAG)、记忆(memory)、子代理(subagent)是同一批工程问题的不同侧面■本节要讲:文档系统·五种上下文策略·Skill(程序性记忆)·审问系统PromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202514ContextRot——上下文越用越傻这是每个vibecoder都踩过的坑现象■记忆混淆:把A文件的逻辑记到B文件上■回答变简单:越到后面越"敷衍"■Bug乱修:改了A引入B,改了B引入C■"上次你说过的那个方案"→AI完全不记得■1M上下文时代反而更容易触发!塞得多,判断压力更大根本原因■窗口满了→早期信息被挤出去■注意力分散→对每一段权重都变低■错误被继续引用→反复回声放大■很多同学从项目开始到结束都不换session■→下一张:Anthropic官方给出的五种应对策略PromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202515§3.6Anthropic官方五种上下文管理策略按场景选择,别只会Ctrl+L清屏策略什么时候用关键动作Continue上下文还有用,切换要付重建代价继续用,别乱动Compact到50%主动手动压缩(别等自动)/compact——保留关键决策与文件路径Clear/NewSession上下文腐坏,明显走偏/clear+依靠progress.txt/Proposal.md恢复Subagents独立子任务(搜索/审计/测试)把污染阻挡在子代理里Rollback走偏了别在错误上下文里修EscEsc——回到checkpoint重来铁律:/context查看用量→到50%手动/compact。别等自动压缩——那时Claude已经注意力涣散了。PromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202516为什么需要Compact——触发机制与预算账Compact不是summarize-and-hope,是工程化的窗口预算管理Outputheadroom给模型下一轮回复留的空间Compactionheadroom跑摘要本身需要的空间Free<reserved→触发两块预留耗尽后立刻压缩Codex的触发阈值公式effective_window=model_context_window−min(max_output_tokens,20000)threshold=effective_window−13000#GPT-5.3-Codex(200kwindow)→约167ktokens触发#硬90%上限:用户设更高的model_auto_compact_token_limit也会被静默压回对比:ClaudeCode用headroomaccounting(未公开数值)·Codex用固定13k保留。PromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202517CodexCompact核心代码——双路径+历史重写codex-rs/core/src/compact.rs·compact_remote_v2.rsLocalpath·compact.rs■任意provider都可用■client侧发起LLM摘要调用■compact_prompt可覆盖为自定义模板Remotepath·compact_remote_v2.rs■仅OpenAI托管■POST/v1/responses/compact→返回encrypted_contentblob■blob回传时服务端解密,client看不到内容■compact_prompt配置被忽略//codex-rs/core/src/compact.rs(line~326)letsummary_suffix=get_last_assistant_message_from_turn(items).unwrap_or_default();letsummary_text=format!("{SUMMARY_PREFIX}\n{summary_suffix}");letuser_messages=collect_user_messages(items);//保留所有用户消息

letnew_history=build_compacted_history(Vec::new(),//←丢掉全部assistant/tool历史&user_messages,//←用户消息原文保留&summary_text,//←摘要作为最后一条user-role消息注入);摘要用user-role注入——让新模型看到的是「指令」不是「上一轮assistant的碎碎念」。PromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202518Codex的两段Prompt——交接的仪式感prompts/templates/compact/{prompt,summary_prefix}.mdSUMMARIZATION_PROMPTprompts/templates/compact/prompt.mdYouareperformingaCONTEXTCHECKPOINTCOMPACTION.CreateahandoffsummaryforanotherLLMthatwillresumethetask.

Include:-Currentprogressandkeydecisionsmade-Importantcontext,constraints,oruserpreferences-Whatremainstobedone(clearnextsteps)-Anycriticaldata,examples,orreferencesneededtocontinue

Beconcise,structured,andfocusedonhelpingthenextLLMseamlesslycontinuethework.SUMMARY_PREFIXprompts/templates/compact/summary_prefix.mdAnotherlanguagemodelstartedtosolvethisproblemandproducedasummaryofitsthinkingprocess.Youalsohaveaccesstothestateofthetoolsthatwereusedbythatlanguagemodel.Usethistobuildontheworkthathasalreadybeendoneandavoidduplicatingwork.Hereisthesummaryproducedbytheotherlanguagemodel,usetheinformationinthissummarytoassistwithyourownanalysis:·摘要用"Youareperforming…"第二人称任务式表达→让LLM写得像交接文档·SUMMARY_PREFIX让新模型知道"这是另一个我",避免自我怀疑·多次compact:filter掉以SUMMARY_PREFIX\n开头的旧摘要,只留最新一份,不叠罗汉PromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202519ClaudeCode的三层Compaction+子代理增量摘要Micro·Auto·Manual·deltasummarizationMicro-compaction早期就shedbulkyread_file的大段结果/grep长列表在进上下文前先压缩Auto-compactionHeadroom触发摘要+rehydrate最近文件、todos,保证光标不丢Manual/compact任务边界显式/compact[focushint]focus参数指导保留哪些内容Subagents·增量摘要(deltasummarization)"Youaregivenafewmessagesfromaconversation,aswellasasummaryoftheconversationsofar.Yourtaskistosummarizethenewmessagesbasedonthesummarysofar.Aimfor1-2sentencesatmost,focusingonthemostimportantdetails."#每次子代理更新只写1-2句新增摘要·不重复处理历史·主会话完全不受影响·Betaheader可直连;tools存在时可能返回content=null(模型半路调工具)·Prompt里必须写"Donotcallanytoolswhilewritingthissummary"·cache_control断点放compactionblock;systemprompt断点分开→防止缓存失效PromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202520AICodingEvolvesSoQuickly——52天出货节奏Claude团队近半年的模型/工具/harness更新时间线模型能力在快速scaling,但你能否吃到红利,取决于上下文和harness是否跟得上。Source:https://lzhu.me/assets/slides/202606-advancing-agent-loops-with-humanize.pdfPromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202521但光靠scaling不够:文档才是唯一真理来源模型每52天更新一次,但你的项目细节它每次都得从零学"AI产生幻觉不是因为它坏了,而是因为你没给它任何可以依靠的东西。没有结构、没有清晰度、没有基础。"——《WhyYouSuckatVibeCoding》■AI是翻译器:把你的意图转换成代码。你的意图是屎,代码也会是屎。■失败模式不是缺乏编码能力,而是缺乏纪律和上下文保存■打开终端→描述App→让AI立即编码——前几个文件后就崩溃■修复方法不是更好的提示词,是更好的理解——加上文档■铁律:文档第一,代码第二。永远。PromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202522§3.2Document-First:六份规范文档全景在写任何一行代码之前,先把这六份文档写掉PRD.md产品需求什么在范围内/什么明确不在用户故事·成功标准APP_FLOW.md用户流程每个页面·每条路径成功态/错误态·路由清单TECH_STACK.md技术栈每个包锁定版本号消除幻觉依赖(React18.2.0…)FRONTEND_GUIDELINES.md前端规范色板·间距·圆角·排版断点·组件命名·视觉令牌BACKEND_STRUCTURE.md后端结构数据库模式·认证逻辑API合约·存储·边缘情况IMPLEMENTATION_PLAN.md实施计划逐步序列1.1→1.2→…步骤越多,AI猜测越少"步骤越多,AI猜测越少。AI猜测越少,幻觉越少。"PromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202523PRD.md/APP_FLOW.md的写法示例"合同级"文档:AI读了就知道"完成"长什么样PRD.md#PRD—StudyTimer##InScope-番茄钟25/5·任务队列·每日统计-本地存储(LocalStorage)·无账号系统##OutofScope(v1)-云同步·团队协作·音效自定义##SuccessCriteria-用户可30秒内完成第一个番茄-关掉浏览器再打开数据不丢##UserStories-作为学生,我想...-作为...APP_FLOW.md#AppFlow##Screens-/Home(进入按钮·今日统计)-/timerTimer(开始/暂停/放弃)-/statsStats(7日折线图)##Flow:开始一个番茄1.Home→点击[开始]→/timer2./timer倒计时25:00→到03.弹提示→计数+1→自动/break##ErrorStates-用户拒绝通知权限→顶部黄条提示-中途关闭→记录为"放弃"防止AI猜测用户如何移动——屏幕清单+路由+每一步决策点。PromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202524TECH_STACK.md/FRONTEND_GUIDELINES.md的写法示例把"版本号"和"视觉令牌"锁死——直接消除两大类幻觉TECH_STACK.md#TechStack(LOCKED)-Node20.11.1-Next.js14.1.0-React18.2.0-TypeScript5.3.3-Tailwind3.4.1-shadcn/ui0.8.0-Vitest1.2.0不允许引入UI库(MUI/Antd)或状态管理库(Redux/Zustand)除非本文件更新过FRONTEND_GUIDELINES.md#DesignSystem##Paletteprimary#1D4ED8danger#DC2626ink#111827dim#6B7280bg#FFFFFFpanel#F3F4F6##Spacingscale(px)4·8·12·16·24·32·48·64##Radius/Shadowradius-sm4·md8·lg12shadow-1012rgba(0,0,0,.06)##TypographyHeadingInter600·BodyInter400##Breakpointssm640·md768·lg1024·xl1280每个视觉决策都要锁定。"看起来好看"不是描述,"backdrop-filter:blur(12px)"才是。PromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202525BACKEND_STRUCTURE.md/IMPLEMENTATION_PLAN.md示例把数据结构和执行顺序都固定下来BACKEND_STRUCTURE.md#Schema##table:pomodoroidTEXTPKstarted_atINTNOTNULL#unixmsdurationINTDEFAULT1500statusTEXTCHECKIN('done','abort')tag_idTEXTFK->tag.idNULLABLE##table:tagidTEXTPKnameTEXTUNIQUEcolorTEXT##APIGET/api/stats?range=7d->DailyStat[]POST/api/pomodorobody:{duration,tag_id}##Auth无(v1)·未来magic-link+JWTIMPLEMENTATION_PLAN.md#BuildOrder1.1pnpmcreatenext-app@14.1.0study-timer1.2安装tailwind/shadcn/vitest1.3建目录:app/components/lib/tests/2.1按FRONTEND_GUIDELINES建<Button>2.2建<TimerCircle>组件(SVG)2.3建<TagPicker>3.1按BACKEND_STRUCTURE建SQLiteschema3.2lib/db.tsCRUD+Vitest单测4.1/timer页拼装·状态机4.2/stats页·折线图5.1集成e2e·pnpmtestIMPLEMENTATION_PLAN让每次会话都能"从断点续跑",AI不用重新猜项目在哪个阶段。PromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202526会话持久层:CLAUDE.md·progress.txt·lessons.md前六份是"图纸",这三份是"操作台"CLAUDE.md≤60行·每次自动读■技术栈摘要·命名约定■设计令牌·组件模式■"允许"与"禁止"清单■指向progress.txt/lessons.md■活文档:每次纠正就更新它progress.txt会话桥梁·断点续跑■已完成/进行中/接下来/已知Bug■每次功能完成后更新■新会话第一件事:读它■没有它→每次都从零上下文开始■有它→AI从断点精确继续lessons.md可选但强推·失败模式库■每次纠正AI后记录一条■格式:现象→原因→防止规则■CLAUDE.md里指向它,让AI每次读■这是把"好CLAUDE.md"与"伟大CLAUDE.md"分开的关键■≈Reflection模式的工程落地PromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202527§3.3Interrogation审问系统——先想清楚再动手PlanMode+95%信心审问法:把"AI幻觉"的源头堵在开工前PromptA·无尽审问(进入PlanMode:Shift+Tab两次)在写任何代码之前,在Planning模式下无尽地审问我的想法。不要假设任何问题。问问题直到没有假设剩下。一次只问一个问题,根据我的回答继续追问。直到你有95%的信心理解我的真实需求和目标,然后才给出方案。PromptB·审问结束后生成规范文档基于我们的审问,生成规范文档:PRD.md、APP_FLOW.md、TECH_STACK.md、FRONTEND_GUIDELINES.md、BACKEND_STRUCTURE.md、IMPLEMENTATION_PLAN.md。要具体且详尽,没有歧义。顺序:审问→文档→代码。永远不要跳过。AI在你的清晰度结束时开始幻觉。PromptEng.▸ContextEng.▸HarnessEng.ContextEngineering·2024-202528§1.4.1Skill——Agent的程序性记忆一个Skill=一份"这类任务的操作手册",可跨项目复用好用Skill的四类信息■任务目标:这个Skill是干什么的■触发条件:什么时候用,什么时候不该用■执行步骤:推荐流程·检查顺序·分支■约束与坑点:Gotchas,只有你知道的经验■Anthropic内部9大类:API参考·产品验证·数据分析■业务流程·代码脚手架·质量Review·CI/CD■Runbook·基建运维目录结构(典型Skill是个"工作包",不只SKILL.md)my-skill/├──SKILL.md←主说明:何时用、怎么用├──references/←参考资料、模板、规范├──scripts/←可直接调用的脚本├──examples/←输入输出示例└──assets/←图、模板、辅助文件Skill编写六条最佳实践■别写废话(重点写Gotchas)■用文件夹做渐进式披露■别绑死Agent,留灵活性■存脚本不重写·按需钩子·测量效果PromptEng.▸ContextEng.▸HarnessEng.HarnessEngineering·2025-202629HarnessEngineering——让模型可靠地行动"harness"=挽具:让一头有力气的野兽真正拉动马车"PromptEngineering是把模型叫醒。ContextEngineering是让模型看见正确的信息。HarnessEngineering是让模型在真实世界里可靠行动。"■工具接口(ToolsAPI/MCP/FunctionCall)■执行环境(Shell·容器·沙箱·权限)■验证(跑测试·静态检查·ReviewerAgent)■治理(Ratelimit·预算·审计日志)■可观测性(每一步都能看、都能回放)■→下一张:这一切被总结为ETCLOVG七层PromptEng.▸ContextEng.▸HarnessEng.HarnessEngineering·2025-202630ETCLOVG七层框架生产级Agent系统的完整解剖图GGovernance治理与安全权限、预算、审计、合规VVerification验证评估跑测试、Reviewer、静态检查、目标达成判定OObservability可观测性轨迹回放、指标、trace、可复现LLifecycle生命周期任务编排、状态机、多Agent协同CContext上下文记忆窗口管理、RAG、progress/lessonsTTooling工具接口Function/MCP/CodeAct、CLI生态EExecution执行环境Shell、容器、沙箱、真实文件系统由下往上:Execution→Tooling→Context→Lifecycle→Observability→Verification→GovernancePromptEng.▸ContextEng.▸HarnessEng.HarnessEngineering·2025-202631核心洞察:只改harness,不改模型,也能10×提升这是"HarnessEngineering"这个词能成立的原因52.8%→66.5%固定模型·重构systemprompt·加入自验证hooks·Terminal-Bench2.0上的绝对提升论文另一组数据■只改编辑工具格式(不动模型本体)■编码benchmark上最高带来10×提升■→工程外壳决定上限■→换更强的模型很贵,改harness几乎零成本对个人的启发■与其等GPT-6,不如把你的6份文档写好■与其换工具,不如把CLAUDE.md精修到60行■模型每天都在更新,harness的红利先吃到■"工程外壳"就是你和别人的差距PromptEng.▸ContextEng.▸HarnessEng.HarnessEngineering·2025-202632§1.4.2MCP——AI世界的USB-C接口ModelContextProtocol,Anthropic提出的开放协议MCP可以理解成什么?可以把它理解成AI世界的USB-C接口。不同工具只要都遵守MCP这套协议,Agent就能用统一方式去发现它、读取它的说明、调用它的能力,而不用为每个工具都单独写一套对接逻辑。■MCPServer做三件事:把能力描述清楚·把输入输出标准化·把底层系统封装起来■典型链路:AgentClient→MCPClient→(标准协议)→MCPServer→你的真实能力■Manus直言"Actually,Manusdoesn'tuseMCP"——走CodeAct路线(让Agent生成可执行代码)■2025-11Anthropic进一步提出:把MCPServer作为CodeAPI提供,Agent按需加载■一句话:Skill解决"怎么做"·MCP解决"怎么接"·CLI解决"在哪执行"PromptEng.▸ContextEng.▸HarnessEng.HarnessEngineering·2025-202633MCP三要素:Tools/Resources/Prompts一个MCPServer通常同时暴露这三类能力Tools可调用动作·search_docs(q)·create_issue(title,body)·send_message(chat,text)·read_db(sql)Resources可读取资源·某个本地文件·某张数据表·某份共享文档·某段项目上下文Prompts可复用提示模板·标准分析提示词·标准codereview提示·会议纪要工作流入口·RCA(根因分析)模板架构:AgentClient→MCPClient→⟨标准协议⟩→MCPServer→{文件·数据库·飞书/微信/GitHubAPI·搜索·业务系统}好处:Agent不需要为每个系统重新学一次"接线方式"——一套协议,随插随用。PromptEng.▸ContextEng.▸HarnessEng.HarnessEngineering·2025-202634实例:ZoteroMCP——让Agent直接操作你的文献库对Agent来说,Zotero不再是"本地软件",而是一组标准工具Tool功能典型自然语言指令search_items(query)按标题/作者/关键词搜索"把Zotero里diffusionpolicy相关的论文按年份列出来"get_item_metadata(id)读取某篇论文的元数据"这篇文章发在什么期刊?作者是谁?年份?摘要?"list_collections()查看文献库分类"我Zotero里有哪些专题文件夹?"get_collection_items(id)读取某专题内所有论文"读取这个collection里的所有论文摘要,帮我整理研究脉络"底层可能是Zotero本地API/插件/同步数据库,但对Agent来说:一组标准MCP工具。PromptEng.▸ContextEng.▸HarnessEng.HarnessEngineering·2025-202635三种工具调用形态:FunctionCall·MCP·CodeAct不是替代关系,各有适用场景形态谁执行动作优点代价/局限FunctionCallLLM输出JSON,宿主执行简单、可控、行为可枚举组合能力弱,一次一个MCP独立MCPServer执行标准化、可插拔、跨客户端复用需要额外部署一层ServerCodeActAgent直接生成Python代码组合能力强、能一次完成复杂动作沙箱要求高,验证/回滚复杂Manus的选择是CodeAct;ClaudeDesktop/Cursor走MCP;OpenAIToolUse是典型FunctionCall。三种形态在真实系统里往往并存。PromptEng.▸ContextEng.▸HarnessEng.HarnessEngineering·2025-202636§1.4.3CLI——Agent真正干活的主战场"Agent一旦进入CLI,就不再只是会聊天"CLI三个关键价值■统一执行入口■文件操作·Shell·测试·构建·Git·Python全串起来■更接近真实生产环境■依赖冲突、路径错、环境变量、权限——只有进终端才暴露■天然适配AgentLoop■读状态→执行→观察→继续,与终端工作方式高度一致"聊天框"下的秘密■很多Agent表面是聊天框,底层其实是CLI+工具链+上下文■没有CLI,Agent停留在"给建议"■有CLI,Agent才能"替你动手"■这也是ClaudeCode/Codex拉开与普通Chat差距的地方■"我回答你怎么做"→"我直接在终端里帮你做"PromptEng.▸ContextEng.▸HarnessEng.HarnessEngineering·2025-202637CLI生态盘点——把不同世界都接到终端里每一个CLI=Agent手里多一条真实动作路径CLI连接对象适合让Agent干什么git/gh代码仓库·Issue·PR·Review提交/分支/提PR/分析diff/触发reviewwx-cli微信生态消息收发·自动回复·通知推送·群变成Agent入口feishu-cli飞书办公套件文档·消息·机器人·多维表格·审批流docker/vercel/cloudflare部署·容器·云函数部署·扩缩容·日志检索·回滚pytest/uv/pnpm本地构建&测试跑测试·依赖管理·打包·出报告规律:谁把自己的世界"CLI化",谁就先被Agent接管。PromptEng.▸ContextEng.▸HarnessEng.HarnessEngineering·2025-202638Skill·MCP·CLI——三支柱的关系"怎么做"/"能调谁"/"在哪执行"Skill怎么做■程序性记忆■任务操作手册■触发条件+步骤+坑点■跨项目复用MCP能调谁■通用工具协议■Tools/Resources/Prompts■把外部世界"USB-C化"■一套协议,随插随用CLI在哪执行■真实执行现场■Shell·Git·Docker·pytest■离生产环境最近■真正让Agent动手三者合一,才是"能落地干活的Agent"。来源:https://lzhu.me/assets/slides/202606-advancing-agent-loops-with-humanize.pdfPromptEng.▸ContextEng.▸HarnessEng.HarnessEngineering·2025-202640§2.4Git——Agent时代的外部记忆系统"没有Git,AI改代码像在沙地上写字"Git在Agent工作流的五大价值■可回滚:Agent改坏了能回上一个稳定点■可对比:AI改了什么一目了然,不是凭感觉验收■可并行:分支/worktree同时推进多任务■可协作:导师·同学·多个Agent围绕同一仓库■可审计:论文代码·实验·结果的变化链路可追踪最小工作流·够大多数同学用gitinit#第一次gitadd.gitcommit-m"init"

#日常gitstatus#看谁改了gitadd.gitcommit-m"finishdatapreprocessing"

#看AI改了什么gitdiffgitlog--oneline--graphPromptEng.▸ContextEng.▸HarnessEng.HarnessEngineering·2025-202641gitworktree——多Agent并行的杀手锏同一仓库的"平行宇宙":底层对象库共享,比clone轻#在上一级目录开一个新工作树·并创建新分支gitworktreeadd../paper-rebuttal-brebuttal

#查看当前所有worktreegitworktreelist

#用完删掉(不删仓库历史)gitworktreeremove../paper-rebuttal四种典型worktree分工■mainworktree■只放稳定、可运行、可提交的版本■experimentworktree■跑新实验、改大逻辑、做高风险尝试■writingworktree■专门给论文/汇报/文档整理■agent-debugworktree■让某个Agent单独折腾,避免污染主现场Git让Agent的行动可追踪,branch让尝试可隔离,worktree让并行成为日常。PromptEng.▸ContextEng.▸HarnessEng.HarnessEngineering·2025-202642主流Agent工具生态——挑对工具比换个模型更重要§1.5+§1.7ClaudeCode/Codex/Hermes/OpenClaw的定位差异工具开发者定位最适合干什么ClaudeCodeAnthropic面向代码仓库的终端Agent写代码·改代码·跑测试·codereviewCodexOpenAI面向真实工程执行的编码Agent长链路debug·审查·自动迭代到完成HermesNousResearch可自我沉淀Skill的通用Agent长期个人助理·跨平台·云端常驻OpenClaw-多渠道消息入口的个人AI助手统一Telegram/Slack/微信入口·数字分身CursorCursorIDE集成·Self-Driving模式IDE内高频微改·视觉即时反馈LangChain/LangGraph-框架·状态图自建Agent系统·精细流程控制一句区分法:ClaudeCode/Codex以"项目"为中心·Hermes/OpenClaw以"人和渠道"为中心。PromptEng.▸ContextEng.▸HarnessEng.HarnessEngineering·2025-202643§1.6ClaudeCode/Codex安装极简指南安装5分钟,环境稳定性决定你后续50小时体验ClaudeCode#macOS/Linux/WSLcurl-fsSLhttps://claude.ai/install.sh|bash

#WindowsPowerShellirmhttps://claude.ai/install.ps1|iex

claude#启动·首次登录Codex#macOS/Linuxcurl-fsSL/codex/install.sh|sh

#WindowsPowerShellnpminstall-g@openai/codex--force--no-os-check

codex#启动·ChatGPT/APIkey登录国内环境三条自救建议■Windows用户优先WSL2:ClaudeCode/Codex/Git/Python工具链更一致■先装Git再装Agent:很多能力都依赖仓库上下文■装完先跑doctor/--version确认工具本身健康■换npm源:npmconfigsetregistryPromptEng.▸ContextEng.▸HarnessEng.ClaudeCode五阶段实战·工程落地44§3.5ClaudeCode高质量开发·五阶段方案综合知识库6+篇深度文章的实战工作流Stage1Interrogation审问需求PlanMode无限追问95%信心Stage2Doc-First文档优先6份规范文档项目"宪法"没有歧义Stage3Scaffold骨架配置CLAUDE.md≤60行progress.txtlessons.mdStage4Implement实施执行Explore-Plan-Implement-CommitSubagents/TeamsStage5QualityGate质量控制/review·/compactEscEsc回滚上下文管理审问→文档(6份)→CLAUDE.md+progress.txt→PlanMode确认→实施→QualityGate→迭代"文档越多→AI猜测越少→质量越高。用文档替代猜测,用流程替代碰运气。"PromptEng.▸ContextEng.▸HarnessEng.ClaudeCode五阶段实战·工程落地45阶段一·Interrogation:PlanMode反问进入方式:Shift+Tab两次Claude应该反问你的问题■给谁用?(用户画像)■核心动作是什么?■完成后发生什么?(成功态)■需要保存哪些数据?■需要展示哪些数据?■错误状态怎么处理?■需要登录吗?需要数据库吗?■需要在手机上工作吗?■离线场景要不要支持?规矩■一次只问一个问题■根据你的回答继续追问■直到95%信心理解真实需求,才给方案■这些答案=六份规范文档的原材料■用户描述→PRD■数据结构→BACKENDSTRUCTURE■流程→APPFLOW■手机需求→FRONTENDGUIDELINES■采访完开新会话执行(对话太长会污染上下文)PromptEng.▸ContextEng.▸HarnessEng.ClaudeCode五阶段实战·工程落地46阶段二·Doc-First+VibeDesign六份规范文档+DESIGN.md终结前端审美灾难DESIGN.md里必须写什么■视觉主题·色彩体系·排版规则■组件样式·布局原则·层次阴影■DO/DON'T清单■响应式行为·Agent提示指南■■资源:awesome-design-md(37k+Stars)■把Claude/Linear/Cursor/Vercel/■Apple/Spotify/Airbnb的设计系统■全部提取成了DESIGN.md风格关键词(直接写入FRONTEND_GUIDELINES.md)Glassmorphismbackdrop-filter:blur()·半透明·磨砂玻璃Neobrutalism粗野原始·厚黑边框·冲突配色BentoGrid便当盒网格·不同大小卡片·视觉节奏DarkMode深色背景+柔和强调色·亮暗双主题秘密武器:截图参考——"匹配这个布局"比任何文字描述强100倍。PromptEng.▸ContextEng.▸HarnessEng.ClaudeCode五阶段实战·工程落地47阶段三·项目骨架:三份持久文件CLAUDE.md(层级)·progress.txt(断点)·lessons.md(失败模式)CLAUDE.md的四层约束体系全局CLAUDE.md(~/.claude/)项目级CLAUDE.md(仓库根)各类规范文档(设计·架构)记忆文件(自动记忆·会话记录)"约束先行":规矩从上往下穿透,一层管一层。#progress.txt(会话桥梁)[Done]-后端SQLiteschema·CRUD单测通过-前端Button/TimerCircle组件[Doing]-/stats页面·7日折线图(卡在SVG)[Next]-集成e2e(Playwright)-部署到Vercel[Bugs]-长时段计时iOS后台会掉lessons.md记录规则■每次纠正AI后写一条·格式:现象→原因→防止规则■例:AI引入lodash→违反TECH_STACK.md→禁止未列出依赖■CLAUDE.md顶部一句话:"每次开工先读lessons.md"■这就是把好的CLAUDE.md和"伟大的"分开的关键PromptEng.▸ContextEng.▸HarnessEng.ClaudeCode五阶段实战·工程落地48阶段四·实施执行:Subagents并行·AgentTeams协同"usesubagents"——一句话让Agent分裂出多路小队单会话模式(中小项目)■Explore→Plan→Implement→Commit■主线保持单一,最简单最稳定■每完成一个可验证小阶段就commit■大改动一律开分支:exp/...·fix/...·writing/...Subagents并行(大项目)#在prompt里加"usesubagents"Createanagentteam:-onebuildsfrontendfollowingFRONTEND_GUIDELINES.md-anotherimplementsbackendfollowingBACKEND_STRUCTURE.md-anotherwritestests

#子代理规则:做功能特定的#("前端组件agent")#不要做通用的"QAagent"

#AgentTeams(需讨论协调的复杂项目)exportCLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1#队友之间可直接对话协作#注

温馨提示

  • 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

评论

0/150

提交评论