mcpField
C
claude-skill

claude-skill

github.com/feiskyerAgent 工作流247137 次安装4 周前更新
代码仓库

关于 claude-skill

通过 Claude Code 的无头命令行准备并运行任务的技能,适用于自动化 Claude Code 工作的用户。它指导命令构建、权限范围设定、兼容性检查和结果验证。

主要功能

  1. 01构建无头 `claude` 命令
  2. 02依据本机帮助检查命令行参数
  3. 03选择范围受限的权限模式
  4. 04检查结果与相关产物

适用场景

  1. 01以无头模式分析代码仓库
  2. 02执行范围明确的编码自动化任务
  3. 03生成 JSON 报告或恢复运行

MCP 相关

该技能包含 MCP 相关命令示例的参考指南,但未说明 MCP 服务或客户端管理功能。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/feiskyer/codex-settings --skill claude-skill

安装后在 Claude Code 中输入/claude-skill确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
examples.md
flags-and-permissions.md

详细介绍

Claude Code 无头模式

为需要通过 Claude Code 本身执行的工作构建并运行 claude 命令。

参考资料适合在以下情况下阅读
references/flags-and-permissions.md命令所需内容不止 -p 时——权限模式、工具范围限制、输出格式、标志清单、安装
references/examples.md想查看特定任务类型的完整命令示例时(只读分析、安全编辑运行、JSON 报告、恢复执行、MCP、沙盒化无人值守运行)

要求目标机器已安装并完成身份验证的 claude CLI。

核心规则

  • 以目标机器上的 claude --help 为兼容性底线。 CLI 标志和权限规则语法的变化速度比文档和复制的示例更快,且不同构建版本之间也有差异。输出任何不常见的标志前,都要先在此处确认。
  • 除非用户要求覆盖,或工作流必须固定模型以确保可复现,否则不要添加 --model。 用户配置的模型就是正确的默认选项。
  • 除非目的是替换 Claude Code 的默认行为,否则优先使用 --append-system-prompt,而不是 --system-prompt。
  • 选择仍能满足任务要求的最低权限模式。 acceptEdits 通常是编码自动化的起点。对于真正的无人值守运行,优先使用明确的权限规则或 dontAsk;只有在环境已隔离的情况下才使用 bypassPermissions。

检查任务需求

执行前,确认 CLI 可用且已完成身份验证。查阅 claude --help,了解此命令所需的标志;对兼容性或安装情况有疑问时,使用版本或诊断命令。用户请求命令示例并不代表授权执行该任务。

基本形式

claude -p "summarize the repository architecture"
claude -p "review the auth layer for risks" --output-format json

其他事项都取决于如何限定工具范围和权限——请参阅参考资料。

何时暂停

遇到缺少凭据、所需功能不可用或需要扩大权限时,应暂停。如果有等效且受支持的命令仍在请求范围内,则直接使用,无需增加审批步骤。

返回内容

对于执行请求,运行已获授权的命令并检查其结果及相关产物;不要只打印命令,也不要把退出代码为零视为已完成所请求工作的证明。如果仍有工作未完成,应在现有范围内继续进行有限的后续操作。对于仅要求提供命令的请求,只返回命令,不要执行。

报告命令、结果、相关检查以及任何权限或验证方面的缺口。只有在工作流计划稍后继续时,才提供恢复执行命令。

评论

支持 Markdown