SuperAPI AI 工具集

claude-skill

编程与开发

查看项目

更新于 10-16 01:33

技能介绍

用途:在用户要求借助 Claude 或 Claude Code 完成某件事(如实现功能设计、审查代码)时,以非交互自动化方式从头到尾执行任务。

前置条件:需已安装并配置 Claude Code CLI。可用 claude --version 验证;若未安装,可引导用户执行 npm install -g @anthropic-ai/claude-code。

主要能力:

  • 无头非交互执行:用 --print(或 -p)运行,如 claude -p "analyze the codebase structure and explain the architecture"。
  • 权限模式:--permission-mode 可选 default、acceptEdits(本技能默认,自动接受文件编辑,但仍需批准 shell 命令)、plan(只读分析,不能改文件或执行命令)、bypassPermissions(跳过所有权限提示,仅限容器/虚拟机等外部沙箱环境,禁止在无隔离的开发机使用)。
  • 工具控制:--allowedTools 与 --disallowedTools 可限定或禁用工具,支持逗号分隔字符串、空格分隔及带限制写法,如 "Bash(npm test),Read"。
  • 输出格式:默认文本;--output-format json 返回含 total_cost_usd、duration_ms、num_turns、result、session_id 等结构化数据;stream-json 流式输出。
  • 多轮会话:--continue(-c)继续最近会话,--resume(-r)按 session ID 恢复。
  • 其他参数:--append-system-prompt 追加自定义系统提示;--mcp-config 加载 MCP 服务器;--verbose 输出调试日志。

执行流程:解析需求、制定精简计划、自主执行、验证结果、结构化汇报。原则是自主完成、不逐步征求确认,仅在破坏性操作、安全决策、需求歧义或关键信息缺失时暂停。

适用场景:代码分析(只读)、修复缺陷、实现功能、批量替换、生成 JSON 报告、SRE 事件响应、PR 安全审查、多轮文档审阅等。

限制与注意事项:bypassPermissions 有安全风险,仅在外部沙箱中使用;长任务可配合 timeout,如 timeout 300 claude -p "$complex_prompt" --permission-mode acceptEdits;需遵守速率限制。错误处理应检查退出码与 stderr,非阻塞错误继续执行并在最终摘要中报告。此类信息为技能说明,具体效果与实际可用性暂未提供。