SuperAPI AI 工具集

command-execution

通用与其它

查看项目

更新于 10-16 00:01

技能介绍

用途:为 AI 智能体执行 shell 命令、安装依赖或运行项目脚本时提供严格规范,避免污染宿主机并保持项目开发接口一致。

主要能力与规则:

  1. 不在宿主机运行项目工具。pnpm、npm、python、pip、pytest、cargo 等应位于 devcontainer 内,安装、构建、测试都通过容器执行,例如 docker exec -it <container_name> pnpm install、docker exec -it <container_name> pnpm build、docker exec -it <container_name> pytest。宿主机仅允许 git、docker / docker compose、gh、npx skills 以及 cat、ls、grep、find 等文件操作。跨项目时只做读文件、git 和 docker 操作,需要构建或测试时进入容器。
  2. 使用项目开发者 API,即根 package.json 脚本,如 pnpm lint、pnpm provision:dev、pnpm build:frontend,而不是进入子目录直接运行 npx cdk deploy 或 npm run build。
  3. 不使用 cd。改用根脚本,或使用 working_dir 参数,例如 execute_bash(command="pnpm synth", working_dir="infrastructure")。
  4. 先发现脚本,可查看 package.json 中的 scripts,关注 lint、test、build、provision:、deploy:。
  5. 安装依赖时,工作区根使用 pnpm add -D -w eslint,指定工作区使用 pnpm add -D eslint --filter frontend,避免 cd frontend && pnpm add eslint。

使用方式:在需要执行命令前先检查根脚本;若必须直接执行,先确认无根脚本、使用 working_dir 并说明原因。

限制:资料未提供具体容器名称、项目结构或更多平台信息;该规范为严格准则,需按原文执行。若开发者纠正了本技能本应避免的行为,建议提出具体修订。