运行命令配置助手
为 VS Code Agent Session 配置和更新运行按钮命令。
技能明确要求先读取现有 tasks.json、合并而非覆盖无关任务,并说明自动运行条件,具备基本范围控制;但对推断出的 shell 命令不要求用户确认,未披露命令的数据流、权限、敏感信息风险或提供回滚/验证步骤,因此扣分。
决策流程和 tasks.json 格式示例清晰,且仓库 package.json 提供可识别的命令;但没有处理无效 JSON、缺失目录、命令失败、跨平台差异或合并冲突的诊断反馈。静态审查且缺少覆盖该技能关键路径的测试证据,按校准限制不超过10分。
目标用户、触发场景、输入文件和输出位置较明确,也覆盖多种项目栈;但非标准项目、复杂多命令项目、平台差异和不应自动安装的场景边界不足,未说明中文交互支持。
技能名称、描述、章节结构、示例和基本行为说明较清楚;仓库 README、MIT 许可证、版本和 Microsoft 归属可提供治理背景,但技能自身没有版本、变更记录、维护责任、安装说明、已知限制或故障排查,因此扣分。
对于简单项目,能够生成可直接用于 Run 按钮的 tasks.json,并说明触发方式;但命令推断可能不完整或不适合该项目,自动安装命令可能产生额外副作用,且没有验证生成结果或代表性输出的证据,按静态校准不超过7分。
技能文本包含可审计的 schema、决策逻辑和示例,仓库还提供 package.json 与一般 CI 文件;但没有针对本技能的测试、固定输入输出样例或第三方执行证据,结论主要依赖静态文档,按校准不超过5分。
- 自动推断并写入 shell 命令,尤其是带 worktreeCreated 的安装命令,可能在未确认时执行网络访问、脚本和副作用;应增加用户确认、命令预览、权限/敏感数据提示和失败后的恢复说明。
- 应明确跨平台命令、多个候选命令、无效或缺失 tasks.json 以及合并冲突的处理方式,并提供生成后 JSON 校验。
- 仓库级 CI 和许可证不能替代该技能自身的测试、版本记录和维护说明。
它能做什么 & 适用场景
该技能帮助用户为当前 Agent Session 工作区设置运行命令。它使用 .vscode/tasks.json 中的任务,让命令显示在会话标题栏的 Run 按钮中。技能会检查现有的 inAgents 任务,并据此决定修改已有配置或推断新命令。它适合需要统一安装、开发服务器或其他工作区运行入口的 VS Code 项目。
读取工作区中的 .vscode/tasks.json,检查是否已有带有 inAgents: true 的任务;如果已有任务,则询问用户要添加、删除还是更新命令;如果没有,则检查 package.json、Makefile、pyproject.toml、Cargo.toml、go.mod、.nvmrc 等项目文件以推断设置和开发命令;将任务合并写入工作区根目录的 .vscode/tasks.json,并配置可选的 worktreeCreated 自动运行。
- 项目维护者希望把依赖安装命令加入新工作树创建时的自动设置流程。
- 开发者希望把开发服务器命令添加到 VS Code Agent Session 的 Run 按钮。
- 已有运行任务的团队成员希望在保留其他任务的前提下更新其中一个命令。
- 使用 package.json、Makefile 或其他常见项目配置的开发者希望自动生成明确的运行入口。
优缺点一览
- 能识别现有 inAgents 任务并按修改请求处理。
- 支持将安装任务设置为 worktreeCreated 时自动运行。
- 会合并现有 tasks.json,而不是覆盖无关任务。
- 可从多种常见项目文件推断设置和开发命令。
- 源材料没有说明独立安装步骤或命令。
- 如果项目结构不明确或存在多个同样合理的命令,需要用户选择。
- 技能只覆盖运行命令配置,不证明会执行、测试或验证生成的命令。
- Run 按钮和 Agent Session 行为依赖相应的 VS Code 工作区环境。
如何安装
该仓库包含 61 个技能,目标文件位于 src/vs/sessions/skills/generate-run-commands/SKILL.md。提供的 README 未说明单独安装该技能的命令;仓库整体采用 MIT 许可证。
如何使用
在包含项目配置的 Agent Session 工作区中提出类似“为这个项目设置运行命令”或“更新 Run 按钮中的开发命令”的请求。技能会先检查 .vscode/tasks.json;完成后,生成的任务可从会话标题栏的 Run 按钮触发。