|
|
@@ -0,0 +1,153 @@
|
|
|
+---
|
|
|
+name: headless-cli
|
|
|
+description: "无头模式 AI CLI 调用技能:支持 Gemini/Claude/Codex 等 CLI 的无交互批量调用,包含 YOLO 模式和安全模式。用于批量翻译、代码审查、多模型编排等场景。"
|
|
|
+---
|
|
|
+
|
|
|
+# Headless CLI 技能
|
|
|
+
|
|
|
+无交互批量调用 AI CLI 工具,支持 stdin/stdout 管道,实现自动化工作流。
|
|
|
+
|
|
|
+## When to Use This Skill
|
|
|
+
|
|
|
+触发条件:
|
|
|
+- 需要批量处理文件(翻译、审查、格式化)
|
|
|
+- 需要在脚本中调用 AI 模型
|
|
|
+- 需要多模型串联/并联处理
|
|
|
+- 需要无人值守的 AI 任务执行
|
|
|
+
|
|
|
+## Not For / Boundaries
|
|
|
+
|
|
|
+不适用于:
|
|
|
+- 需要交互式对话的场景
|
|
|
+- 需要实时反馈的任务
|
|
|
+- 敏感操作(YOLO 模式需谨慎)
|
|
|
+
|
|
|
+必需输入:
|
|
|
+- 已安装对应 CLI 工具
|
|
|
+- 已完成身份认证
|
|
|
+- 网络代理配置(如需)
|
|
|
+
|
|
|
+## Quick Reference
|
|
|
+
|
|
|
+### 🔴 YOLO 模式(全权限,跳过确认)
|
|
|
+
|
|
|
+**Codex CLI (GPT-5.1)**
|
|
|
+```bash
|
|
|
+alias c='codex --enable web_search_request -m gpt-5.1-codex-max -c model_reasoning_effort="high" --dangerously-bypass-approvals-and-sandbox'
|
|
|
+```
|
|
|
+
|
|
|
+**Claude Code**
|
|
|
+```bash
|
|
|
+alias cc='claude --dangerously-skip-permissions'
|
|
|
+```
|
|
|
+
|
|
|
+**Gemini CLI**
|
|
|
+```bash
|
|
|
+alias g='gemini --yolo'
|
|
|
+```
|
|
|
+
|
|
|
+### 🟢 安全模式(无头但有限制)
|
|
|
+
|
|
|
+**Gemini CLI(禁用工具调用)**
|
|
|
+```bash
|
|
|
+cat input.md | gemini -m gemini-2.5-flash --output-format text --allowed-tools '' "prompt" > output.md
|
|
|
+```
|
|
|
+
|
|
|
+**Claude Code(指定模型)**
|
|
|
+```bash
|
|
|
+cat input.md | claude -m claude-sonnet-4 --output-format text "prompt" > output.md
|
|
|
+```
|
|
|
+
|
|
|
+### 📋 常用命令模板
|
|
|
+
|
|
|
+**批量翻译**
|
|
|
+```bash
|
|
|
+# 设置代理(如需)
|
|
|
+export http_proxy=http://127.0.0.1:9910
|
|
|
+export https_proxy=http://127.0.0.1:9910
|
|
|
+
|
|
|
+# Gemini 翻译
|
|
|
+cat zh.md | gemini -m gemini-2.5-flash --output-format text --allowed-tools '' \
|
|
|
+ "Translate to English. Keep code/links unchanged." > en.md
|
|
|
+```
|
|
|
+
|
|
|
+**代码审查**
|
|
|
+```bash
|
|
|
+cat code.py | claude --dangerously-skip-permissions \
|
|
|
+ "Review this code for bugs and security issues. Output markdown." > review.md
|
|
|
+```
|
|
|
+
|
|
|
+**多模型编排**
|
|
|
+```bash
|
|
|
+# 模型 A 生成 → 模型 B 审查
|
|
|
+cat spec.md | gemini -m gemini-2.5-flash --output-format text "Generate code" | \
|
|
|
+ claude -m claude-sonnet-4 "Review and improve this code" > result.md
|
|
|
+```
|
|
|
+
|
|
|
+### ⚙️ 关键参数说明
|
|
|
+
|
|
|
+| CLI | 参数 | 说明 |
|
|
|
+|:---|:---|:---|
|
|
|
+| gemini | `--yolo` | 跳过所有确认 |
|
|
|
+| gemini | `--allowed-tools ''` | 禁用工具调用(纯文本输出) |
|
|
|
+| gemini | `--output-format text` | 输出纯文本 |
|
|
|
+| gemini | `-m <model>` | 指定模型 |
|
|
|
+| claude | `--dangerously-skip-permissions` | 跳过权限确认 |
|
|
|
+| codex | `--dangerously-bypass-approvals-and-sandbox` | 跳过审批和沙箱 |
|
|
|
+| codex | `-c model_reasoning_effort="high"` | 高推理强度 |
|
|
|
+
|
|
|
+## Examples
|
|
|
+
|
|
|
+### Example 1: 批量翻译文档
|
|
|
+
|
|
|
+**输入**: 中文 Markdown 文件
|
|
|
+**步骤**:
|
|
|
+```bash
|
|
|
+export http_proxy=http://127.0.0.1:9910
|
|
|
+export https_proxy=http://127.0.0.1:9910
|
|
|
+
|
|
|
+for f in docs/*.md; do
|
|
|
+ cat "$f" | timeout 120 gemini -m gemini-2.5-flash --output-format text --allowed-tools '' \
|
|
|
+ "Translate to English. Keep code fences unchanged." 2>/dev/null > "en_$(basename $f)"
|
|
|
+done
|
|
|
+```
|
|
|
+**预期输出**: 翻译后的英文文件
|
|
|
+
|
|
|
+### Example 2: 代码审查流水线
|
|
|
+
|
|
|
+**输入**: Python 代码文件
|
|
|
+**步骤**:
|
|
|
+```bash
|
|
|
+cat src/*.py | claude --dangerously-skip-permissions \
|
|
|
+ "Review for: 1) Bugs 2) Security 3) Performance. Output markdown table." > review.md
|
|
|
+```
|
|
|
+**预期输出**: Markdown 格式的审查报告
|
|
|
+
|
|
|
+### Example 3: 多模型对比验证
|
|
|
+
|
|
|
+**输入**: 技术问题
|
|
|
+**步骤**:
|
|
|
+```bash
|
|
|
+question="How to implement rate limiting in Python?"
|
|
|
+
|
|
|
+echo "$question" | gemini -m gemini-2.5-flash --output-format text > gemini_answer.md
|
|
|
+echo "$question" | claude -m claude-sonnet-4 --output-format text > claude_answer.md
|
|
|
+
|
|
|
+# 对比两个答案
|
|
|
+paste gemini_answer.md claude_answer.md | diff -y --suppress-common-lines
|
|
|
+```
|
|
|
+**预期输出**: 两个模型答案的对比
|
|
|
+
|
|
|
+## References
|
|
|
+
|
|
|
+- `references/gemini-cli.md` - Gemini CLI 完整参数
|
|
|
+- `references/claude-cli.md` - Claude Code CLI 参数
|
|
|
+- `references/codex-cli.md` - Codex CLI 参数
|
|
|
+- [Gemini CLI 官方文档](https://github.com/google-gemini/gemini-cli)
|
|
|
+- [Claude Code 官方文档](https://docs.anthropic.com/claude-code)
|
|
|
+
|
|
|
+## Maintenance
|
|
|
+
|
|
|
+- 来源: 各 CLI 官方文档
|
|
|
+- 更新: 2025-12-19
|
|
|
+- 限制: 需要网络连接和有效认证;YOLO 模式有安全风险
|