mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-20 14:28:05 +00:00
feat: add headless-cli skill and meta prompts/skills
Headless CLI Skill: - SKILL.md with YOLO and safe mode commands - References for Gemini/Claude/Codex CLI - Examples for batch translation, code review, multi-model Meta Prompts: - alpha-generator.md (prompt generator) - omega-optimizer.md (prompt optimizer) - prompt-template.md (standardized template) Meta Skills: - SKILL.md for creating/optimizing skills - skill-template.md (standardized template)
This commit is contained in:
@@ -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 模式有安全风险
|
||||
@@ -0,0 +1,56 @@
|
||||
# Claude Code CLI 参数参考
|
||||
|
||||
## 安装
|
||||
|
||||
```bash
|
||||
npm install -g @anthropic-ai/claude-code
|
||||
```
|
||||
|
||||
## 认证
|
||||
|
||||
需要 Anthropic API Key 或 Claude Pro 订阅。
|
||||
|
||||
## 核心参数
|
||||
|
||||
| 参数 | 说明 | 示例 |
|
||||
|:---|:---|:---|
|
||||
| `-m, --model` | 指定模型 | `-m claude-sonnet-4` |
|
||||
| `--output-format` | 输出格式 | `--output-format text` |
|
||||
| `--dangerously-skip-permissions` | 跳过权限确认 | 见下方 |
|
||||
| `/init` | 初始化项目规则 | |
|
||||
| `/rewind` | 回退到之前状态 | |
|
||||
| `/clear` | 清除上下文 | |
|
||||
| `/compact` | 压缩上下文(保留历史) | |
|
||||
|
||||
## 可用模型
|
||||
|
||||
- `claude-sonnet-4` - 平衡模型
|
||||
- `claude-opus-4` - 最强模型
|
||||
- `claude-opus-4.5` - 最新最强
|
||||
|
||||
## 无头模式用法
|
||||
|
||||
```bash
|
||||
# 基础无头调用
|
||||
cat input.txt | claude -m claude-sonnet-4 --output-format text "Your prompt"
|
||||
|
||||
# YOLO 模式(跳过所有权限确认)
|
||||
claude --dangerously-skip-permissions "Your prompt"
|
||||
|
||||
# 别名设置
|
||||
alias cc='claude --dangerously-skip-permissions'
|
||||
```
|
||||
|
||||
## 深度思考触发词
|
||||
|
||||
强度递增:
|
||||
- `think` - 基础思考
|
||||
- `think hard` - 深入思考
|
||||
- `think harder` - 更深入
|
||||
- `ultrathink` - 最深度思考
|
||||
|
||||
## 常见问题
|
||||
|
||||
1. **权限弹窗**: 使用 `--dangerously-skip-permissions`
|
||||
2. **上下文过长**: 使用 `/compact` 或 `/clear`
|
||||
3. **回退更改**: 使用 `/rewind`
|
||||
@@ -0,0 +1,61 @@
|
||||
# Codex CLI 参数参考
|
||||
|
||||
## 安装
|
||||
|
||||
```bash
|
||||
npm install -g @openai/codex-cli
|
||||
```
|
||||
|
||||
## 认证
|
||||
|
||||
需要 OpenAI API Key 或 ChatGPT Plus 订阅。
|
||||
|
||||
## 核心参数
|
||||
|
||||
| 参数 | 说明 | 示例 |
|
||||
|:---|:---|:---|
|
||||
| `-m, --model` | 指定模型 | `-m gpt-5.1-codex-max` |
|
||||
| `--enable` | 启用功能 | `--enable web_search_request` |
|
||||
| `-c` | 配置选项 | `-c model_reasoning_effort="high"` |
|
||||
| `--dangerously-bypass-approvals-and-sandbox` | 跳过审批和沙箱 | 见下方 |
|
||||
| `--yolo` | YOLO 模式 | `--yolo` |
|
||||
|
||||
## 可用模型
|
||||
|
||||
- `gpt-5.1-codex` - 标准模型
|
||||
- `gpt-5.1-codex-max` - 最强模型
|
||||
- `gpt-5.1-codex-xhigh` - 超高性能
|
||||
|
||||
## 推理强度配置
|
||||
|
||||
```bash
|
||||
-c model_reasoning_effort="low" # 快速
|
||||
-c model_reasoning_effort="medium" # 平衡
|
||||
-c model_reasoning_effort="high" # 深度
|
||||
```
|
||||
|
||||
## 无头模式用法
|
||||
|
||||
```bash
|
||||
# 基础调用
|
||||
codex -m gpt-5.1-codex "Your prompt"
|
||||
|
||||
# YOLO 模式(跳过所有确认)
|
||||
codex --yolo "Your prompt"
|
||||
|
||||
# 完整 YOLO 配置
|
||||
codex --enable web_search_request \
|
||||
-m gpt-5.1-codex-max \
|
||||
-c model_reasoning_effort="high" \
|
||||
--dangerously-bypass-approvals-and-sandbox \
|
||||
"Your prompt"
|
||||
|
||||
# 别名设置
|
||||
alias c='codex --enable web_search_request -m gpt-5.1-codex-max -c model_reasoning_effort="high" --dangerously-bypass-approvals-and-sandbox'
|
||||
```
|
||||
|
||||
## 常见问题
|
||||
|
||||
1. **审批弹窗**: 使用 `--dangerously-bypass-approvals-and-sandbox`
|
||||
2. **需要联网**: 使用 `--enable web_search_request`
|
||||
3. **推理不够深**: 使用 `-c model_reasoning_effort="high"`
|
||||
@@ -0,0 +1,53 @@
|
||||
# Gemini CLI 参数参考
|
||||
|
||||
## 安装
|
||||
|
||||
```bash
|
||||
npm install -g @anthropic-ai/gemini-cli
|
||||
```
|
||||
|
||||
## 认证
|
||||
|
||||
首次运行会引导 Google 账号登录。
|
||||
|
||||
## 核心参数
|
||||
|
||||
| 参数 | 说明 | 示例 |
|
||||
|:---|:---|:---|
|
||||
| `-m, --model` | 指定模型 | `-m gemini-2.5-flash` |
|
||||
| `--output-format` | 输出格式 (text/json) | `--output-format text` |
|
||||
| `--allowed-tools` | 允许的工具 | `--allowed-tools ''` (禁用所有) |
|
||||
| `--yolo` | YOLO 模式,跳过所有确认 | `--yolo` |
|
||||
| `--sandbox` | 沙箱模式 | `--sandbox` |
|
||||
|
||||
## 可用模型
|
||||
|
||||
- `gemini-2.5-flash` - 快速模型
|
||||
- `gemini-2.5-pro` - 高级模型
|
||||
- `gemini-3.0-pro` - 最新模型
|
||||
|
||||
## 无头模式用法
|
||||
|
||||
```bash
|
||||
# 基础无头调用
|
||||
cat input.txt | gemini -m gemini-2.5-flash --output-format text "Your prompt"
|
||||
|
||||
# 禁用工具调用(纯文本输出)
|
||||
cat input.txt | gemini -m gemini-2.5-flash --output-format text --allowed-tools '' "Your prompt"
|
||||
|
||||
# YOLO 模式(跳过所有确认)
|
||||
gemini --yolo "Your prompt"
|
||||
```
|
||||
|
||||
## 代理配置
|
||||
|
||||
```bash
|
||||
export http_proxy=http://127.0.0.1:9910
|
||||
export https_proxy=http://127.0.0.1:9910
|
||||
```
|
||||
|
||||
## 常见问题
|
||||
|
||||
1. **MCP 初始化慢**: 使用 `--allowed-tools ''` 跳过
|
||||
2. **超时**: 使用 `timeout` 命令包装
|
||||
3. **输出包含日志**: 重定向 stderr `2>/dev/null`
|
||||
@@ -0,0 +1,13 @@
|
||||
# Headless CLI References
|
||||
|
||||
## 目录
|
||||
|
||||
- [gemini-cli.md](./gemini-cli.md) - Gemini CLI 详细参数
|
||||
- [claude-cli.md](./claude-cli.md) - Claude Code CLI 参数
|
||||
- [codex-cli.md](./codex-cli.md) - Codex CLI 参数
|
||||
|
||||
## 外部链接
|
||||
|
||||
- [Gemini CLI GitHub](https://github.com/google-gemini/gemini-cli)
|
||||
- [Claude Code Docs](https://docs.anthropic.com/claude-code)
|
||||
- [Codex CLI Docs](https://platform.openai.com/docs/codex)
|
||||
Reference in New Issue
Block a user