[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6G2808TR5AEH8WRKSN65CS8":3,"skill-same:01M6G2808TR5AEH8WRKSN65CS8":61},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":26,"publishedAt":32,"linkOnly":33,"markdownContent":34,"markdownBody":35,"frontMatter":36,"refName":38,"commitSha":39,"skillDirectory":40,"forksCount":41,"repositoryHtmlUrl":42,"repositoryHomepageUrl":6,"ownerHtmlUrl":43,"ownerBlogUrl":44,"ownerDescription":45,"updatedAt":46,"install":47,"resources":60},"01M6G2808TR5AEH8WRKSN65CS8","agent-harness-construction",null,"设计和优化AI代理的动作空间、工具定义和观察格式，以提高完成率。","oabdelmaksoud\u002FAgention","oabdelmaksoud","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F50699149?v=4","01M6D5CVVN778ZCDP1WHS816SP","Omar Abdelmaksoud","01M6D8A4TE76V3DCSH3D94VG1V",2,"MIT","https:\u002F\u002Fgithub.com\u002Foabdelmaksoud\u002FAgention\u002Fblob\u002Fmain\u002Fupstream-sync\u002Fwork\u002Fecc\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fagent-harness-construction\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[27,28,29,30,31],"harness","agent harness","agent harness construction","design","工具","2026-11-10 10:12:30",false,"---\nname: agent-harness-construction\ndescription: 设计和优化AI代理的动作空间、工具定义和观察格式，以提高完成率。\norigin: ECC\n---\n\n# 智能体框架构建\n\n当你在改进智能体的规划、调用工具、从错误中恢复以及收敛到完成状态的方式时，使用此技能。\n\n## 核心模型\n\n智能体输出质量受限于：\n\n1. 行动空间质量\n2. 观察质量\n3. 恢复质量\n4. 上下文预算质量\n\n## 行动空间设计\n\n1. 使用稳定、明确的工具名称。\n2. 保持输入模式优先且范围狭窄。\n3. 返回确定性的输出形状。\n4. 除非无法隔离，否则避免使用全能型工具。\n\n## 粒度规则\n\n* 对高风险操作（部署、迁移、权限）使用微工具。\n* 对常见的编辑\u002F读取\u002F搜索循环使用中等工具。\n* 仅当往返开销是主要成本时使用宏工具。\n\n## 观察设计\n\n每个工具响应都应包括：\n\n* `status`: success|warning|error\n* `summary`: 一行结果\n* `next_actions`: 可执行的后续步骤\n* `artifacts`: 文件路径 \u002F ID\n\n## 错误恢复契约\n\n对于每个错误路径，应包括：\n\n* 根本原因提示\n* 安全重试指令\n* 明确的停止条件\n\n## 上下文预算管理\n\n1. 保持系统提示词最少且不变。\n2. 将大量指导信息移至按需加载的技能中。\n3. 优先引用文件，而不是内联长文档。\n4. 在阶段边界处进行压缩，而不是任意的令牌阈值。\n\n## 架构模式指导\n\n* ReAct：最适合路径不确定的探索性任务。\n* 函数调用：最适合结构化的确定性流程。\n* 混合模式（推荐）：ReAct 规划 + 类型化工具执行。\n\n## 基准测试\n\n跟踪：\n\n* 完成率\n* 每项任务的重试次数\n* pass@1 和 pass@3\n* 每个成功任务的成本\n\n## 反模式\n\n* 太多语义重叠的工具。\n* 不透明的工具输出，没有恢复提示。\n* 仅输出错误而没有后续步骤。\n* 上下文过载，包含不相关的引用。\n","# 智能体框架构建\n\n当你在改进智能体的规划、调用工具、从错误中恢复以及收敛到完成状态的方式时，使用此技能。\n\n## 核心模型\n\n智能体输出质量受限于：\n\n1. 行动空间质量\n2. 观察质量\n3. 恢复质量\n4. 上下文预算质量\n\n## 行动空间设计\n\n1. 使用稳定、明确的工具名称。\n2. 保持输入模式优先且范围狭窄。\n3. 返回确定性的输出形状。\n4. 除非无法隔离，否则避免使用全能型工具。\n\n## 粒度规则\n\n* 对高风险操作（部署、迁移、权限）使用微工具。\n* 对常见的编辑\u002F读取\u002F搜索循环使用中等工具。\n* 仅当往返开销是主要成本时使用宏工具。\n\n## 观察设计\n\n每个工具响应都应包括：\n\n* `status`: success|warning|error\n* `summary`: 一行结果\n* `next_actions`: 可执行的后续步骤\n* `artifacts`: 文件路径 \u002F ID\n\n## 错误恢复契约\n\n对于每个错误路径，应包括：\n\n* 根本原因提示\n* 安全重试指令\n* 明确的停止条件\n\n## 上下文预算管理\n\n1. 保持系统提示词最少且不变。\n2. 将大量指导信息移至按需加载的技能中。\n3. 优先引用文件，而不是内联长文档。\n4. 在阶段边界处进行压缩，而不是任意的令牌阈值。\n\n## 架构模式指导\n\n* ReAct：最适合路径不确定的探索性任务。\n* 函数调用：最适合结构化的确定性流程。\n* 混合模式（推荐）：ReAct 规划 + 类型化工具执行。\n\n## 基准测试\n\n跟踪：\n\n* 完成率\n* 每项任务的重试次数\n* pass@1 和 pass@3\n* 每个成功任务的成本\n\n## 反模式\n\n* 太多语义重叠的工具。\n* 不透明的工具输出，没有恢复提示。\n* 仅输出错误而没有后续步骤。\n* 上下文过载，包含不相关的引用。\n",{"name":5,"origin":37,"description":7},"ECC","main","a318f48de3c5718e8ea2e9f6fae7790e8a759e85","upstream-sync\u002Fwork\u002Fecc\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fagent-harness-construction",0,"https:\u002F\u002Fgithub.com\u002Foabdelmaksoud\u002FAgention","https:\u002F\u002Fgithub.com\u002Foabdelmaksoud","https:\u002F\u002Fwww.linkedin.com\u002Fin\u002Fo-abdelmaksoud\u002F","Full-Stack Engineer | AI Systems Architect | Building autonomous multi-agent systems","2026-03-08 21:23:03",{"source":8,"skillName":5,"commands":48,"prompt":58,"zipAvailable":59},[49,52,55],{"tool":50,"command":51},"npx","npx skills add oabdelmaksoud\u002FAgention --skill agent-harness-construction",{"tool":53,"command":54},"bunx","bunx skills add oabdelmaksoud\u002FAgention --skill agent-harness-construction",{"tool":56,"command":57},"pnpm","pnpm dlx skills add oabdelmaksoud\u002FAgention --skill agent-harness-construction","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Foabdelmaksoud\u002FAgention\u002Fblob\u002Fmain\u002Fupstream-sync\u002Fwork\u002Fecc\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fagent-harness-construction\u002FSKILL.md",true,[],[62,84,98,129,155,175],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":71,"publishedAt":32},"01M6G2QFCBNBYAJF2KTK85G9A6","visa-doc-translate","Translate visa application documents (images) to English and create a bilingual PDF with original and translation","https:\u002F\u002Fgithub.com\u002Foabdelmaksoud\u002FAgention\u002Fblob\u002Fmain\u002Fupstream-sync\u002Fwork\u002Fecc\u002Fskills\u002Fvisa-doc-translate\u002FSKILL.md",[68],{"categoryNo":69,"categoryName":70,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000002","文档处理",[72,73,74,75,76,77,78,79,80,81,82,83],"translate","doc","visa doc translate","bilingual","with","english","application","PDF","translation","documents","create","images",{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":32},"01M6G2QB09TSK6BY4ME5X20EVQ","verification-loop","A comprehensive verification system for Claude Code sessions.","https:\u002F\u002Fgithub.com\u002Foabdelmaksoud\u002FAgention\u002Fblob\u002Fmain\u002Fupstream-sync\u002Fwork\u002Fecc\u002Fskills\u002Fverification-loop\u002FSKILL.md",[],[91,92,93,94,95,96,97],"verification","loop","verification loop","sessions","code","claude code sessions","system",{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":113,"publishedAt":32},"01M6G2Q6V2F7G03VAAF27FXPJR","tdd-workflow","Use this skill when writing new features, fixing bugs, or refactoring code. Enforces test-driven development with 80%+ coverage including unit, integration, and E2E tests.","https:\u002F\u002Fgithub.com\u002Foabdelmaksoud\u002FAgention\u002Fblob\u002Fmain\u002Fupstream-sync\u002Fwork\u002Fecc\u002Fskills\u002Ftdd-workflow\u002FSKILL.md",[104,107,108],{"categoryNo":105,"categoryName":106,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":109,"categoryName":110,"taxonomyType":111,"taxonomyTypeDesc":112},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[114,115,116,117,118,119,120,121,122,95,123,124,125,126,76,127,128],"workflow","tdd","tdd workflow","use","unit","coverage","refactoring","e2e","integration","development","e2e tests","tests","driven","test","writing",{"skillNo":130,"name":131,"nameZh":6,"description":132,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":133,"categories":134,"keywords":135,"publishedAt":32},"01M6G2Q359YJRWAR2PFCEQAXF3","swiftui-patterns","SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS\u002FmacOS UI best practices.","https:\u002F\u002Fgithub.com\u002Foabdelmaksoud\u002FAgention\u002Fblob\u002Fmain\u002Fupstream-sync\u002Fwork\u002Fecc\u002Fskills\u002Fswiftui-patterns\u002FSKILL.md",[],[136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,76],"patterns","swiftui","swiftui patterns","architecture","macos","performance","state management","best practices","state","ui","Optimization","ios","architecture patterns","Composition","performance optimization","view","management","swiftui architecture","navigation",{"skillNo":156,"name":157,"nameZh":6,"description":158,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":159,"categories":160,"keywords":162,"publishedAt":32},"01M6G2PY8B2FWZTWPZ84H83Y7C","swift-protocol-di-testing","Protocol-based dependency injection for testable Swift code — mock file system, network, and external APIs using focused protocols and Swift Testing.","https:\u002F\u002Fgithub.com\u002Foabdelmaksoud\u002FAgention\u002Fblob\u002Fmain\u002Fupstream-sync\u002Fwork\u002Fecc\u002Fskills\u002Fswift-protocol-di-testing\u002FSKILL.md",[161],{"categoryNo":105,"categoryName":106,"taxonomyType":21,"taxonomyTypeDesc":22},[163,164,165,166,95,167,168,169,170,97,171,172,173,174],"swift protocol di testing","protocol","swift","testing","protocols","file","network","injection","dependency","swift testing","dependency injection","mock",{"skillNo":176,"name":177,"nameZh":6,"description":178,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":179,"categories":180,"keywords":181,"publishedAt":32},"01M6G2PSCN2GXV9FFZDRRRWVB6","swift-concurrency-6-2","Swift 6.2 Approachable Concurrency — single-threaded by default, @concurrent for explicit background offloading, isolated conformances for main actor types.","https:\u002F\u002Fgithub.com\u002Foabdelmaksoud\u002FAgention\u002Fblob\u002Fmain\u002Fupstream-sync\u002Fwork\u002Fecc\u002Fskills\u002Fswift-concurrency-6-2\u002FSKILL.md",[],[182,183,184,165,185,38,186],"concurrency","swift concurrency","swift concurrency 6 2","default","types"]