尧图网站建设 
【免费下载链接】learn-harness-engineeringHarness engineering beginner tutorial, from 0 to 1项目地址https://gitcode.com/gh_mirrors/le/learn-harness-engineering点击查看免费下载导读本文围绕 learn-harness-engineering 仓库中《Initializer Agent Playbook》文档展开讲解在正式增量开发之前如何通过一次初始化会话为仓库建立稳定运行工作面让后续任何没有前文上下文的 Agent 新会话都能独立回答仓库做什么、怎么启动、怎么验证、什么未完成、下一步做什么。文中以本仓库 project-01 的 solution 目录 为真实落点逐条对照AGENTS.md、CLAUDE.md、feature_list.json、claude-progress.md、init.sh等工件说明每个产出物的职责、写法与验证方法供你在自己的仓库里直接照搬执行。这个 Playbook 解决什么问题在 Agent如 Claude Code、Codex 等驱动的开发流程中会话通常是一次性的新会话开始时没有前一次对话的记忆只能从仓库文件本身重建上下文。如果仓库没有一份自解释的运行说明每个新会话都会重复推导启动命令、猜测当前状态、自己划定任务边界——这既浪费时间也容易产生不一致的结论。Playbook 的目标非常明确在一次初始化会话中把启动路径、验证路径、当前状态、任务边界全部固化成仓库中的持久工件使后续增量功能开发可以跳过重新推导环节直接进入实现。这一设计思路与本仓库的系列课程如 lecture-03 关于仓库必须成为系统记录源、lecture-06 关于初始化需要独立阶段一脉相承可参考 docs/zh/lectures/lecture-06-why-initialization-needs-its-own-phase。必需产出初始化会话至少要留下五个工件原文档明确要求初始化器至少留下以下工件本文结合 project-01/solution 的真实文件逐一说明。1. 根指令文件AGENTS.md 或 CLAUDE.md这是给所有未来会话看的宪法通常放在仓库根目录。它要回答这个仓库怎么被正确对待包括启动顺序、架构边界、约定和完成标准。project-01/solution/AGENTS.md 是一个可参考的模板其结构包含Startup Rules启动规则写代码前按顺序执行的步骤——先完整读本文件、再读架构文档与产品文档、运行bash init.sh验证构建、最后读feature_list.json了解功能现状Electron Layer Boundaries分层边界明确 main / preload / renderer / services 四层各自的职责与禁止事项例如 renderer 禁止 import Node.js 模块Conventions编码约定如 TypeScript 严格模式、使用命名导出、IPC 通道名统一收口在src/shared/types.tsDefinition of Done完成定义一个功能完成需要同时满足编译通过、应用可启动、feature_list.json状态更新且有证据、遵守分层边界、运行期无控制台报错。CLAUDE.md则作为针对 Claude Code 的快速参考通过AGENTS.md引用主文件避免双份内容漂移——project-01/solution/CLAUDE.md 中就是用一行AGENTS.md导入然后只保留构建命令、关键文件表、架构规则和如何新增功能的六步流程。这种一份完整指令 一份轻量引用的组合可以让不同 Agent 工具都能快速对齐。2. 机器可读的功能面feature_list.json人类读进度日志Agent 读机器可解析的 JSON。feature_list.json的价值在于结构固定、状态字段明确任何会话都能用代码快速解析还有哪些没做完。project-01/solution/feature_list.json 展示了推荐的字段结构{ project: project-01, description: Baseline Electron knowledge base with minimal harness, features: [ { id: window-launch, name: Window Launch, description: Electron app opens a BrowserWindow with correct dimensions and preload script, status: pass, evidence: npm run dev launches window at 1200x800 with contextIsolationtrue and nodeIntegrationfalse, testedAt: 2026-03-30T10:00:00Z } ] }每个功能条目包含id、name、description、status、evidence、testedAt。status取值为pass/fail/not-started三态实现完成并验证后置为pass并附上证据被阻塞则置为fail并写明原因AGENTS.md还约定了一条重要规则——永不从列表中删除功能条目保证历史与边界可追溯。证据字段应具体到命令和可观察结果如上面window-launch的 evidence这样后续会话不用重新验证就能信任状态。3. 持久进度工件claude-progress.md进度日志记录发生了什么、当时怎么决策、下一步是什么。它不是写给过程看的形式主义而是跨会话连续性的核心载体。project-01/solution/claude-progress.md 的 Session 1 记录展示了应包含的信息会话编号与日期、耗时与目标、实际完成事项清单、关键决策如用构造器注入 PersistenceService 保持可测试性IPC 通道名统一收口在 types.ts、遗留问题以及给下一次会话的明确指引Proceed to Project 02…。其中决策部分尤其重要——它把隐性的上下文变成显性知识让后续会话不必重新权衡一遍。4. 标准启动辅助脚本init.sh把装依赖 类型检查 构建这些开机动作固化成一条命令是消除启动路径歧义的最直接手段。project-01/solution/init.sh 展示了最小可用写法#!/usr/bin/env bash # init.sh -- Verify the project builds cleanly before starting work. # Run this after cloning or when resuming work. set -euo pipefail echo Project 01 Init echo echo [1/3] Installing dependencies... npm install echo echo [2/3] Running type checks... npm run check echo echo [3/3] Building project... npm run build echo echo Init complete. All checks passed. echo Run npm run dev to launch the application.注意set -euo pipefail任一环节失败立即退出并返回非零状态避免假成功。脚本末尾打印下一步提示把启动路径进一步收敛为bash init.sh后npm run dev。package.json中对应的脚本定义在 projects/project-01/solution/package.jsondev通过node scripts/dev.js启动 Electroncheck用两个 tsconfig 分别做tsc --noEmitbuild先tsc -p tsconfig.node.json编译主进程/预加载/共享/服务层再vite build打包 renderer。5. 初始安全提交最后一个工件是记录基础脚手架当前状态的第一次提交。它的意义是建立一个干净的、可回退的基线此后所有增量功能都从这一提交出发diff 始终可审、可回滚。从源码结构看project-01 的基线脚手架projects/project-01/solution/src 下的 main / preload / renderer / services 四层骨架以及 ARCHITECTURE.md 中描述的层间调用关系正是 Playbook 所说的baseline scaffold。首次提交前应保证init.sh全流程通过、feature_list.json与claude-progress.md已写入初始状态再提交从而让初始状态本身可被任何后续会话随时检出。检查清单初始化会话的五步执行顺序原文档把初始化过程压缩为五步检查清单执行顺序如下定义标准启动路径——确定从克隆到可运行的确切命令序列写进AGENTS.md的 Startup Rules并用init.sh固化定义标准验证路径——确定如何确认工作正常在 project-01 中即npm run check类型检查与npm run dev窗口可见的 Definition of Done 判定同时配合测试命令project-01/solution/CLAUDE.md 中的npm test建立进度日志并写下初始状态——创建claude-progress.md如实记录本次会话做了什么、基于什么决策把工作拆成功能并给出状态字段——在feature_list.json中列出所有功能条目未完成的一律not-started完成且验证过的标pass并附证据建立第一个干净的 baseline commit——在上述四步全部完成、验证全绿之后提交作为后续所有增量的起点。这五步的顺序本身就有讲究先有怎么跑、怎么验的约定再记录状态最后才提交基线——保证提交快照与文档、功能列表完全一致。成功标准用无上下文新会话做验收Playbook 最精彩之处在于它的验收方式——不是看初始化器自己觉得做完了而是看一个完全没有前文聊天上下文的新会话能否独立回答五个问题问题对应工件在 project-01 中的落点这个仓库是做什么的AGENTS.md/CLAUDE.md的项目概览、docs/PRODUCT.md知识库桌面应用文档导入、分块索引、带引用的问答怎么启动init.shAGENTS.mdStartup Rulesbash init.sh后npm run dev怎么验证Definition of Done package.json脚本npm run check、npm run dev、npm test什么还没做完feature_list.json的状态字段所有status ! pass的条目下一步最佳动作是什么claude-progress.md的 Next sessionProceed to Project 02 to add import, detail view, and persistence features这五个问题恰好对应本文开头的目标启动路径怎么启动、当前状态做什么、什么没做完、任务边界下一步做什么都被显式固化。如果你的新会话只需读仓库文件就能答出这五点初始化阶段就算真正完成如果答不出其中任何一点说明对应工件缺失或写得不够自解释需要补强后再进入增量开发。在你自己仓库中执行 Playbook 的要点结合原文档与仓库实例实际落地时建议注意指令文件单一事实来源AGENTS.md作为主文件CLAUDE.md用AGENTS.md引用避免同一规则在多个文件里漂移失同步功能列表永不删条目状态可以变not-started→pass/fail但条目本身保留让任务边界可追溯证据要可复现feature_list.json的evidence写成可重跑的命令与可观察结果而不是模糊描述进度日志记录决策而非流水账重点写为什么这么做因为决策是跨会话最有价值的隐性知识基线提交前先全绿确保init.sh通过、进度与功能列表已写入再打第一次提交保证基线快照干净可用。总结《Initializer Agent Playbook》提供了一套轻量但完整的初始化仪式一份根指令、一个机器可读功能面、一份持久进度日志、一个启动辅助脚本、一次干净基线提交。本仓库的 project-01/solution 是这套方法的完整落地方案五个工件与五步清单、五个验收问题一一对应。在你自己的 Agent 驱动项目中照此执行一次初始化会话就能把每次重新推导上下文的成本一次性结清——后续每一个无记忆的新会话都能从仓库本身获得全部启动信息、状态信息和边界信息直接开始增量实现。赞分享【免费下载链接】learn-harness-engineeringHarness engineering beginner tutorial, from 0 to 1项目地址https://gitcode.com/gh_mirrors/le/learn-harness-engineering点击查看免费下载相关推荐初始化代理手册Initializer Agent Playbook在 learn-harness-engineering 中为 Agent 仓库建立首个稳定运行表面初始化代理手册Initializer Agent Playbook在 learn harness engineering 中为 Agent 仓库建立首个稳Initializer Agent Playbook为 Agent 仓库建立稳定操作表面的初始化阶段实战指南Initializer Agent Playbook为 Agent 仓库建立稳定操作表面的初始化阶段实战指南 本文以 learn harness enginelearn-harness-engineering 实战Initializer Agent Playbook——用一次专职初始化会话为后续 Agent 建立稳定操作面learn harness engineering 实战Initializer Agent Playbook——用一次专职初始化会话为后续 Agent 建立稳创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 初始化代理操作手册：用 Initializer Agent Playbook 为 Agent 仓库建立稳定的运行工作面
【免费下载链接】learn-harness-engineeringHarness engineering beginner tutorial, from 0 to 1项目地址https://gitcode.com/gh_mirrors/le/learn-harness-engineering点击查看免费下载导读本文围绕 learn-harness-engineering 仓库中《Initializer Agent Playbook》文档展开讲解在正式增量开发之前如何通过一次初始化会话为仓库建立稳定运行工作面让后续任何没有前文上下文的 Agent 新会话都能独立回答仓库做什么、怎么启动、怎么验证、什么未完成、下一步做什么。文中以本仓库 project-01 的 solution 目录 为真实落点逐条对照AGENTS.md、CLAUDE.md、feature_list.json、claude-progress.md、init.sh等工件说明每个产出物的职责、写法与验证方法供你在自己的仓库里直接照搬执行。这个 Playbook 解决什么问题在 Agent如 Claude Code、Codex 等驱动的开发流程中会话通常是一次性的新会话开始时没有前一次对话的记忆只能从仓库文件本身重建上下文。如果仓库没有一份自解释的运行说明每个新会话都会重复推导启动命令、猜测当前状态、自己划定任务边界——这既浪费时间也容易产生不一致的结论。Playbook 的目标非常明确在一次初始化会话中把启动路径、验证路径、当前状态、任务边界全部固化成仓库中的持久工件使后续增量功能开发可以跳过重新推导环节直接进入实现。这一设计思路与本仓库的系列课程如 lecture-03 关于仓库必须成为系统记录源、lecture-06 关于初始化需要独立阶段一脉相承可参考 docs/zh/lectures/lecture-06-why-initialization-needs-its-own-phase。必需产出初始化会话至少要留下五个工件原文档明确要求初始化器至少留下以下工件本文结合 project-01/solution 的真实文件逐一说明。1. 根指令文件AGENTS.md 或 CLAUDE.md这是给所有未来会话看的宪法通常放在仓库根目录。它要回答这个仓库怎么被正确对待包括启动顺序、架构边界、约定和完成标准。project-01/solution/AGENTS.md 是一个可参考的模板其结构包含Startup Rules启动规则写代码前按顺序执行的步骤——先完整读本文件、再读架构文档与产品文档、运行bash init.sh验证构建、最后读feature_list.json了解功能现状Electron Layer Boundaries分层边界明确 main / preload / renderer / services 四层各自的职责与禁止事项例如 renderer 禁止 import Node.js 模块Conventions编码约定如 TypeScript 严格模式、使用命名导出、IPC 通道名统一收口在src/shared/types.tsDefinition of Done完成定义一个功能完成需要同时满足编译通过、应用可启动、feature_list.json状态更新且有证据、遵守分层边界、运行期无控制台报错。CLAUDE.md则作为针对 Claude Code 的快速参考通过AGENTS.md引用主文件避免双份内容漂移——project-01/solution/CLAUDE.md 中就是用一行AGENTS.md导入然后只保留构建命令、关键文件表、架构规则和如何新增功能的六步流程。这种一份完整指令 一份轻量引用的组合可以让不同 Agent 工具都能快速对齐。2. 机器可读的功能面feature_list.json人类读进度日志Agent 读机器可解析的 JSON。feature_list.json的价值在于结构固定、状态字段明确任何会话都能用代码快速解析还有哪些没做完。project-01/solution/feature_list.json 展示了推荐的字段结构{ project: project-01, description: Baseline Electron knowledge base with minimal harness, features: [ { id: window-launch, name: Window Launch, description: Electron app opens a BrowserWindow with correct dimensions and preload script, status: pass, evidence: npm run dev launches window at 1200x800 with contextIsolationtrue and nodeIntegrationfalse, testedAt: 2026-03-30T10:00:00Z } ] }每个功能条目包含id、name、description、status、evidence、testedAt。status取值为pass/fail/not-started三态实现完成并验证后置为pass并附上证据被阻塞则置为fail并写明原因AGENTS.md还约定了一条重要规则——永不从列表中删除功能条目保证历史与边界可追溯。证据字段应具体到命令和可观察结果如上面window-launch的 evidence这样后续会话不用重新验证就能信任状态。3. 持久进度工件claude-progress.md进度日志记录发生了什么、当时怎么决策、下一步是什么。它不是写给过程看的形式主义而是跨会话连续性的核心载体。project-01/solution/claude-progress.md 的 Session 1 记录展示了应包含的信息会话编号与日期、耗时与目标、实际完成事项清单、关键决策如用构造器注入 PersistenceService 保持可测试性IPC 通道名统一收口在 types.ts、遗留问题以及给下一次会话的明确指引Proceed to Project 02…。其中决策部分尤其重要——它把隐性的上下文变成显性知识让后续会话不必重新权衡一遍。4. 标准启动辅助脚本init.sh把装依赖 类型检查 构建这些开机动作固化成一条命令是消除启动路径歧义的最直接手段。project-01/solution/init.sh 展示了最小可用写法#!/usr/bin/env bash # init.sh -- Verify the project builds cleanly before starting work. # Run this after cloning or when resuming work. set -euo pipefail echo Project 01 Init echo echo [1/3] Installing dependencies... npm install echo echo [2/3] Running type checks... npm run check echo echo [3/3] Building project... npm run build echo echo Init complete. All checks passed. echo Run npm run dev to launch the application.注意set -euo pipefail任一环节失败立即退出并返回非零状态避免假成功。脚本末尾打印下一步提示把启动路径进一步收敛为bash init.sh后npm run dev。package.json中对应的脚本定义在 projects/project-01/solution/package.jsondev通过node scripts/dev.js启动 Electroncheck用两个 tsconfig 分别做tsc --noEmitbuild先tsc -p tsconfig.node.json编译主进程/预加载/共享/服务层再vite build打包 renderer。5. 初始安全提交最后一个工件是记录基础脚手架当前状态的第一次提交。它的意义是建立一个干净的、可回退的基线此后所有增量功能都从这一提交出发diff 始终可审、可回滚。从源码结构看project-01 的基线脚手架projects/project-01/solution/src 下的 main / preload / renderer / services 四层骨架以及 ARCHITECTURE.md 中描述的层间调用关系正是 Playbook 所说的baseline scaffold。首次提交前应保证init.sh全流程通过、feature_list.json与claude-progress.md已写入初始状态再提交从而让初始状态本身可被任何后续会话随时检出。检查清单初始化会话的五步执行顺序原文档把初始化过程压缩为五步检查清单执行顺序如下定义标准启动路径——确定从克隆到可运行的确切命令序列写进AGENTS.md的 Startup Rules并用init.sh固化定义标准验证路径——确定如何确认工作正常在 project-01 中即npm run check类型检查与npm run dev窗口可见的 Definition of Done 判定同时配合测试命令project-01/solution/CLAUDE.md 中的npm test建立进度日志并写下初始状态——创建claude-progress.md如实记录本次会话做了什么、基于什么决策把工作拆成功能并给出状态字段——在feature_list.json中列出所有功能条目未完成的一律not-started完成且验证过的标pass并附证据建立第一个干净的 baseline commit——在上述四步全部完成、验证全绿之后提交作为后续所有增量的起点。这五步的顺序本身就有讲究先有怎么跑、怎么验的约定再记录状态最后才提交基线——保证提交快照与文档、功能列表完全一致。成功标准用无上下文新会话做验收Playbook 最精彩之处在于它的验收方式——不是看初始化器自己觉得做完了而是看一个完全没有前文聊天上下文的新会话能否独立回答五个问题问题对应工件在 project-01 中的落点这个仓库是做什么的AGENTS.md/CLAUDE.md的项目概览、docs/PRODUCT.md知识库桌面应用文档导入、分块索引、带引用的问答怎么启动init.shAGENTS.mdStartup Rulesbash init.sh后npm run dev怎么验证Definition of Done package.json脚本npm run check、npm run dev、npm test什么还没做完feature_list.json的状态字段所有status ! pass的条目下一步最佳动作是什么claude-progress.md的 Next sessionProceed to Project 02 to add import, detail view, and persistence features这五个问题恰好对应本文开头的目标启动路径怎么启动、当前状态做什么、什么没做完、任务边界下一步做什么都被显式固化。如果你的新会话只需读仓库文件就能答出这五点初始化阶段就算真正完成如果答不出其中任何一点说明对应工件缺失或写得不够自解释需要补强后再进入增量开发。在你自己仓库中执行 Playbook 的要点结合原文档与仓库实例实际落地时建议注意指令文件单一事实来源AGENTS.md作为主文件CLAUDE.md用AGENTS.md引用避免同一规则在多个文件里漂移失同步功能列表永不删条目状态可以变not-started→pass/fail但条目本身保留让任务边界可追溯证据要可复现feature_list.json的evidence写成可重跑的命令与可观察结果而不是模糊描述进度日志记录决策而非流水账重点写为什么这么做因为决策是跨会话最有价值的隐性知识基线提交前先全绿确保init.sh通过、进度与功能列表已写入再打第一次提交保证基线快照干净可用。总结《Initializer Agent Playbook》提供了一套轻量但完整的初始化仪式一份根指令、一个机器可读功能面、一份持久进度日志、一个启动辅助脚本、一次干净基线提交。本仓库的 project-01/solution 是这套方法的完整落地方案五个工件与五步清单、五个验收问题一一对应。在你自己的 Agent 驱动项目中照此执行一次初始化会话就能把每次重新推导上下文的成本一次性结清——后续每一个无记忆的新会话都能从仓库本身获得全部启动信息、状态信息和边界信息直接开始增量实现。赞分享【免费下载链接】learn-harness-engineeringHarness engineering beginner tutorial, from 0 to 1项目地址https://gitcode.com/gh_mirrors/le/learn-harness-engineering点击查看免费下载相关推荐初始化代理手册Initializer Agent Playbook在 learn-harness-engineering 中为 Agent 仓库建立首个稳定运行表面初始化代理手册Initializer Agent Playbook在 learn harness engineering 中为 Agent 仓库建立首个稳Initializer Agent Playbook为 Agent 仓库建立稳定操作表面的初始化阶段实战指南Initializer Agent Playbook为 Agent 仓库建立稳定操作表面的初始化阶段实战指南 本文以 learn harness enginelearn-harness-engineering 实战Initializer Agent Playbook——用一次专职初始化会话为后续 Agent 建立稳定操作面learn harness engineering 实战Initializer Agent Playbook——用一次专职初始化会话为后续 Agent 建立稳创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考