人工智能AI 技能MCP 服务AI 评测【免费下载链接】OpenSpaceOpenSpace: The Skill Management Layer for AI Agents -- https://open-space.cloud/项目地址https://gitcode.com/gh_mirrors/opens/OpenSpace点击查看免费下载本指南基于 OpenSpace 仓库 GDPVal 基准技能库中的 ppt-workflow-location 技能文档展开系统讲解委托 shell_agent 生成 PPT → 定位输出 → 拷贝归位 → 验证成品的完整链路。你将从中学到如何在文档生成工具失败时切换到 shell_agent 委派路径、如何应对文件被写入嵌套目录的常见问题以及这条工作流在 OpenSpace 技能演化与 GDPVal 评估体系中的底层原理。技能定位一份来自技能库的可复用工作流ppt-workflow-location是 OpenSpace 仓库 benchmarks/gdpval/skills/ 技能库中的一个演化技能其SKILL.md的 frontmatter 明确了它的职责--- name: ppt-workflow-location description: Generate PowerPoint files using shell_agent and locate them in nested workspace directories ---从仓库结构看每个技能目录都遵循目录名 SKILL.md.skill_id的组织方式例如该技能目录下包含 SKILL.md 与 .skill_id 两个文件。这些技能由 run_benchmark.py 驱动的 GDPVal 两阶段实验在运行过程中自动演化沉淀而来属于从真实任务失败与重试中提炼出的可复用模式与 OpenSpace 核心的Skill Management Layer定位一脉相承。何时使用该技能技能文档明确给出三条适用判据满足其一即应触发该工作流直接文档生成工具失败或不可用——OpenSpace 中诸如run_shell、execute_code_sandbox等直接执行路径对复杂 PPT 生成不可靠时应切换到委派路径需要创建具有特定幻灯片内容与结构的 PowerPoint 演示文稿——即任务规格明确页数、每页主题、要点列表值得交给专门的 shell_agent 执行输出文件可能落在工作区内未预期的嵌套目录——这是 agent 类工具生成文件的典型特征技能的核心价值之一就是解决文件生成成功但找不到的问题。Step 1通过 shell_agent 生成 PowerPoint技能要求以清晰的规格把 PPT 创建任务委托给shell_agent委托内容必须包含四要素指定精确的幻灯片页数定义每页的内容/主题要求以清晰的文件名保存例如presentation.pptx要求 agent 在创建完成后确认文件路径。技能给出了可直接复用的任务描述模板Create a PowerPoint presentation with 10 slides covering [topic]. Each slide should have a title and bullet points. Save it as presentation.pptx and tell me the full file path.这条委派思路与 OpenSpace 内置的 delegate-task 主机技能一脉相承后者通过 MCP 工具execute_task把任务委托给 OpenSpace 实例并支持max_iterations默认 20复杂任务可调高、search_scope默认all本地 云端等参数。在 GDPVal 基准场景中shell_agent 委派的底层对应的是 run_benchmark.py 中通过ExecutionRequest(prompt..., task_id..., workspace_dir...)发起的任务执行——每个任务都拥有独立的workspace_dir这也是输出文件可能散落在不同嵌套目录的根本原因。Step 2定位输出文件嵌套目录问题由shell_agent生成的 PowerPoint 文件可能位于工作区的嵌套目录中技能要求一律先定位、后使用禁止臆断文件位置。核心命令# 在工作区中查找所有 .pptx 文件 find . -name *.pptx -type f # 或按具体文件名搜索 find . -name presentation.pptx -type f为什么文件会出现在嵌套目录从 run_benchmark.py 的_make_config与_run_single_task可以看到每个任务的工作目录被构造为results/run_name/workspace/phase/task_id的多层结构run_benchmark.py 中task_workspace str(rd / workspace / phase / tid)。agent 若在子目录中执行脚本产物自然落在深层路径因此find . -name *.pptx -type f是技能要求的第一步也是后面所有步骤的前提。Step 3拷贝到工作目录定位成功后将文件归位到当前工作目录cp与mv皆可# 把找到的文件拷贝到当前目录 cp /path/to/found/presentation.pptx . # 或者直接移动 mv /path/to/found/presentation.pptx .更稳健的写法是直接用find捕获路径并交给cp这也是增强版技能 ppt-workflow-location-enhanced 采用的模式FILE_PATH$(find . -name presentation.pptx -type f | head -1) cp $FILE_PATH .Step 4验证文件确认文件存在、可访问且非空# 列出文件详情 ls -la presentation.pptx # 检查文件类型与大小确保不是空文件 file presentation.pptx验证环节在 OpenSpace 的评估体系中同样关键GDPVal 的工件发现逻辑_discover_artifactsrun_benchmark.py只会把非零字节、且不属于参考文件的.pptx等工件纳入评估范围——_ARTIFACT_EXTENSIONS中明确包含.pdf、.docx、.xlsx、.pptx等文档扩展名run_benchmark.py。也就是说文件为空0 字节不仅意味着交付失败还会直接导致该任务在 LLM 评估环节拿不到任何分数。更严格的验证可以进一步用python-pptx重新打开文件并统计幻灯片数量这在增强版技能中有完整示例。常见陷阱技能文档总结了四条高频教训均为实战踩坑经验不要假设文件在当前目录——shell_agent可能在子目录中创建文件不要跳过 find 步骤——操作前务必确认文件实际位置检查文件大小——确保 PPT 文件非空0 字节即视为生成失败要求确认——让shell_agent在创建后回报文件路径。这四条与技能名中的 Location 直接呼应生成只是第一步可靠地找到并确认产物才是交付闭环的收尾。端到端示例技能给出了完整的四步串联示例# Step 1: shell_agent 创建演示文稿通过任务委派完成 # Step 2: 定位创建出的文件 find . -name *.pptx -type f # 输出: ./workspace/task_123/output/presentation.pptx # Step 3: 拷贝到工作目录 cp ./workspace/task_123/output/presentation.pptx . # Step 4: 验证 ls -la presentation.pptx # 输出: -rw-r--r-- 1 user user 45632 Jan 15 10:30 presentation.pptx注意示例中find输出的路径./workspace/task_123/output/presentation.pptx与基准运行时的目录结构完全吻合——这印证了嵌套目录是该场景下的常态而非偶然。故障排查表技能文档提供了四类高频问题的对照解决方案问题解决方案用 find 找不到文件扩大搜索范围find / -name *.pptx 2/dev/null文件为 0 字节重新运行 shell_agent 任务确保其成功完成权限被拒绝用ls -la检查父目录权限找到多个 .pptx 文件使用更精确的搜索find . -name *presentation*.pptx在此基础上技能家族还沉淀了更细粒度的排查手段例如 pptx-debug-workflow 建议在调试阶段用python your_script.py 21 | tee debug_output.log捕获完整 traceback并在脚本开头print(os.getcwd())消除工作目录歧义。技能家族从定位到韧性生成ppt-workflow-location并非孤立技能它与技能库中一系列 PPT 相关技能构成完整的故障处理梯度ppt-workflow-location-enhanced双路径设计——Path 1 主路径仍走shell_agentPath 2 回退路径改为直接编写 Python 脚本调用python-pptx生成并强调21重定向以捕获真实报错否则 stderr 被吞掉只看到 unknown errorpptx-debug-workflow系统化的python-pptx调试流程覆盖安装验证、最小脚本测试、图表图例位置XL_LEGEND_POSITIONvsXL_CHART_TYPE、表格单元格访问table.rows[row].cells[cell]等常见 API 陷阱pptx-file-validation、pptx-shell-verify、pptx-validation-fallback分别从文件校验、shell 侧验证、验证回退三个角度补齐闭环。这种定位型技能 回退型技能 调试型技能的家族化沉淀正是 GDPVal 两阶段实验Phase 1 冷启动积累技能 → Phase 2 全量复用技能库所希望验证的效果技能越多后续同类任务的代际成本越低。在 GDPVal 基准中的角色从技能到评估闭环要理解这份技能为什么这样设计需要把它放回 benchmarks/gdpval/README.md 描述的基准框架中基准基于 GDPVal 数据集220 个职业任务覆盖 44 个职业、9 个行业每个任务独立工作区运行每个任务执行后会记录 token 用量、迭代次数、工具调用、技能增减skills.before/skills.after并即时写入phase*_results.jsonlrun_benchmark.py产物评估使用 ClawWork 的 LLM 评估器采用相同 rubric 与 0.6 支付门槛_MIN_EVALUATION_THRESHOLDrun_benchmark.py——分数低于 0.6 的任务实际支付为 0。因此ppt-workflow-location中验证文件非空 确认路径的每一步最终都会转化为评估得分与支付金额的差异而skills/目录中这些 SKILL.md 正是技能演化引擎在任务执行后捕捉的可复用工作流模式。读者若想深入理解技能如何被检索、调用与演化可进一步阅读 run_benchmark.py 的执行记录结构以及 delegate-task 中关于execute_task返回evolved_skills含origin、upload_ready等字段的处理约定。小结ppt-workflow-location用最精炼的四步委托生成 → find 定位 → 拷贝归位 → 验证成品解决了 Agent 场景下文档生成了却找不到/不确认这一高频痛点。它既是一份可直接复制执行的实操清单也是 OpenSpace 技能体系中定位型技能的典型样本——与其同族的增强、调试、校验技能共同构成了 PPT 生成任务的完整韧性方案。在实际使用中请始终遵循其核心纪律不假设文件位置、不跳过 find、不放过 0 字节文件、始终要求回报路径。赞分享人工智能AI 技能MCP 服务AI 评测【免费下载链接】OpenSpaceOpenSpace: The Skill Management Layer for AI Agents -- https://open-space.cloud/项目地址https://gitcode.com/gh_mirrors/opens/OpenSpace点击查看免费下载相关推荐OpenSpace 文档生成降级工作流当 shell_agent 报错时用 write_file run_shell pandoc 手工拆分多格式文档生成OpenSpace 文档生成降级工作流当 shell_agent 报错时用 write_file run_shell pandoc 手工拆分多格式文人工智能AI 技能MCP 服务AI 评测OpenSpace Agent 文件操作降级实战execute_code_sandbox 与 shell_agent 失败时如何用 run_shell 兜底OpenSpace Agent 文件操作降级实战execute_code_sandbox 与 shell_agent 失败时如何用 run_shell 兜底人工智能AI 技能MCP 服务AI 评测SDL 摄像机模块完整指南5 步跑通实时画面获取与热插拔处理SDL 摄像机模块完整指南5 步跑通实时画面获取与热插拔处理 用户打开语音聊天窗口的瞬间画面黑了几秒随后图像突然亮起。这片黑屏不是 bug而是相机曝光的人工智能AI 技能MCP 服务AI 评测上一篇基于Windows钩子注入技术的全局热键冲突检测机制深度解析下一篇Candle 实战在 Rust 中运行 Mixtral-8x7B 稀疏专家混合模型Sparse Mixture of Experts创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
