marshall0524/agent-harness-construction
docs/zh-CN/skills/agent-harness-construction/SKILL.md
设计和优化AI代理的动作空间、工具定义和观察格式，以提高完成率。
$ install --global
skillsauthnpx skillsauth add marshall0524/everythingclaudecode agent-harness-constructionInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Mar 29, 2026, 5:52 AM36.7s1 file scanned
SKILL.md
- name:
- agent-harness-construction
- description:
- 设计和优化AI代理的动作空间、工具定义和观察格式，以提高完成率。
- origin:
- ECC
智能体框架构建
当你在改进智能体的规划、调用工具、从错误中恢复以及收敛到完成状态的方式时，使用此技能。
核心模型
智能体输出质量受限于：
- 行动空间质量
- 观察质量
- 恢复质量
- 上下文预算质量
行动空间设计
- 使用稳定、明确的工具名称。
- 保持输入模式优先且范围狭窄。
- 返回确定性的输出形状。
- 除非无法隔离，否则避免使用全能型工具。
粒度规则
- 对高风险操作（部署、迁移、权限）使用微工具。
- 对常见的编辑/读取/搜索循环使用中等工具。
- 仅当往返开销是主要成本时使用宏工具。
观察设计
每个工具响应都应包括：
status: success|warning|errorsummary: 一行结果next_actions: 可执行的后续步骤artifacts: 文件路径 / ID
错误恢复契约
对于每个错误路径，应包括：
- 根本原因提示
- 安全重试指令
- 明确的停止条件
上下文预算管理
- 保持系统提示词最少且不变。
- 将大量指导信息移至按需加载的技能中。
- 优先引用文件，而不是内联长文档。
- 在阶段边界处进行压缩，而不是任意的令牌阈值。
架构模式指导
- ReAct：最适合路径不确定的探索性任务。
- 函数调用：最适合结构化的确定性流程。
- 混合模式（推荐）：ReAct 规划 + 类型化工具执行。
基准测试
跟踪：
- 完成率
- 每项任务的重试次数
- pass@1 和 pass@3
- 每个成功任务的成本
反模式
- 太多语义重叠的工具。
- 不透明的工具输出，没有恢复提示。
- 仅输出错误而没有后续步骤。
- 上下文过载，包含不相关的引用。
Related Skills
marshall0524/visa-doc-translate
documentation
VerifiedTrustedCommunity
Translate visa application documents (images) to English and create a bilingual PDF with original and translation
13SKILL.mdUpdated Apr 21, 2026
marshall0524/videodb
tools
VerifiedTrustedCommunity
See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.
13SKILL.mdUpdated Apr 21, 2026
marshall0524/verification-loop
development
VerifiedTrustedCommunity
A comprehensive verification system for Claude Code sessions.
13SKILL.mdUpdated Apr 21, 2026
marshall0524/tdd-workflow
development
VerifiedTrustedCommunity
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.
13SKILL.mdUpdated Apr 21, 2026