gavindiaz/vibe-coding-cn
1
0
Fork 0
mirror of https://github.com/tradecatlabs/vibe-coding-cn.git synced 2026-08-13 02:48:05 +00:00
Code Issues Packages Projects Releases Wiki Activity

chore: migrate repository to standard knowledge base layout

Browse Source
This commit is contained in:
tukuaiai
2026-05-02 03:29:06 +08:00
parent 40a721c24d
commit 628a3bc832
565 changed files with 687 additions and 711 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skills/headless-cli/SKILL.md
+175
View File
@@ -0,0 +1,175 @@
---
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**
```bash
# --yolo 是 --dangerously-bypass-approvals-and-sandbox 的别名
alias c='codex --enable web_search_request -m gpt-5.5 -c model_reasoning_effort="xhigh" --yolo'
```
**Claude Code**
```bash
alias cc='claude --dangerously-skip-permissions'
```
**Gemini CLI**
```bash
# --yolo 或 --approval-mode yolo
alias g='gemini --yolo'
```
### 🟡 Full-Auto 模式（推荐的自动化方式）
**Codex CLI**
```bash
# workspace-write 沙箱 + 失败时才审批
codex --full-auto "Your prompt"
```
**Gemini CLI**
```bash
# 自动批准编辑工具
gemini --approval-mode auto_edit "Your prompt"
```
### 🟢 安全模式（无头但有限制）
**Gemini CLI（禁用工具调用）**
```bash
cat input.md | gemini -p "prompt" --output-format text --allowed-tools '' > output.md
```
**Claude Code（Print 模式）**
```bash
cat input.md | claude -p "prompt" --output-format text > output.md
```
**Codex CLI（非交互执行）**
```bash
codex exec "prompt" --json -o result.txt
```
### 📋 常用命令模板
**批量翻译**
```bash
# 设置代理（如需）
export http_proxy=http://127.0.0.1:9910
export https_proxy=http://127.0.0.1:9910
# Gemini 翻译
cat zh.md | gemini -p "Translate to English. Keep code/links unchanged." \
--output-format text --allowed-tools '' > en.md
```
**代码审查**
```bash
cat code.py | claude --dangerously-skip-permissions -p \
"Review this code for bugs and security issues. Output markdown." > review.md
```
**多模型编排**
```bash
# 模型 A 生成 → 模型 B 审查
cat spec.md | gemini -p "Generate code" --output-format text | \
claude -p "Review and improve this code" --output-format text > result.md
```
### ⚙️ 关键参数对照表
| 功能 | Gemini CLI | Claude Code | Codex CLI |
|:---|:---|:---|:---|
| YOLO 模式 | `--yolo` | `--dangerously-skip-permissions` | `--yolo` |
| 指定模型 | `-m <model>` | `--model <model>` | `-m <model>` |
| 非交互 | `-p "prompt"` | `-p "prompt"` | `exec "prompt"` |
| 输出格式 | `--output-format text` | `--output-format text` | `--json` |
| 禁用工具 | `--allowed-tools ''` | `--disallowedTools` | N/A |
| 继续对话 | N/A | `-c` / `--continue` | `resume --last` |
## 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 -p \
"Translate to English. Keep code fences unchanged." \
--output-format text --allowed-tools '' 2>/dev/null > "en_$(basename $f)"
done
```
**预期输出**: 翻译后的英文文件
### Example 2: 代码审查流水线
**输入**: Python 代码文件
**步骤**:
```bash
cat src/*.py | claude --dangerously-skip-permissions -p \
"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 -p "$question" --output-format text > gemini_answer.md
echo "$question" | claude -p "$question" --output-format text > claude_answer.md
# 对比两个答案
diff gemini_answer.md claude_answer.md
```
**预期输出**: 两个模型答案的对比
## References
- `references/gemini-cli.md` - Gemini CLI 完整参数
- `references/claude-cli.md` - Claude Code CLI 参数
- `references/codex-cli.md` - Codex CLI 参数
- [Gemini CLI 官方文档](https://geminicli.com/docs/)
- [Claude Code 官方文档](https://docs.anthropic.com/en/docs/claude-code/)
- [Codex CLI 官方文档](https://developers.openai.com/codex/cli/reference)
## Maintenance
- 来源: 各 CLI 官方文档
- 更新: 2025-12-19
- 限制: 需要网络连接和有效认证；YOLO 模式有安全风险
skills/headless-cli/references/claude-cli.md
+115
View File
@@ -0,0 +1,115 @@
# Claude Code CLI 参数参考
> 来源: [官方文档](https://docs.anthropic.com/en/docs/claude-code/cli-reference)
## 安装
```bash
npm install -g @anthropic-ai/claude-code
```
## 认证
需要 Anthropic API Key 或 Claude Pro/Max 订阅：
```bash
export ANTHROPIC_API_KEY="YOUR_API_KEY"
```
## 核心命令
| 命令 | 说明 | 示例 |
|:---|:---|:---|
| `claude` | 启动交互式 REPL | `claude` |
| `claude "query"` | 带初始提示词启动 | `claude "explain this"` |
| `claude -p "query"` | Print 模式，执行后退出 | `claude -p "review code"` |
| `claude -c` | 继续最近的对话 | `claude -c` |
| `claude -c -p "query"` | 继续对话（Print 模式） | `claude -c -p "run tests"` |
| `claude -r "id" "query"` | 恢复指定会话 | `claude -r "abc123" "continue"` |
| `claude update` | 更新到最新版本 | `claude update` |
| `claude mcp` | 配置 MCP 服务器 | `claude mcp add server` |
## CLI 参数
| 参数 | 说明 | 示例 |
|:---|:---|:---|
| `--model` | 指定模型 | `--model claude-sonnet-4` |
| `--output-format` | 输出格式: `text`/`json`/`stream-json` | `--output-format json` |
| `--max-turns` | 限制对话轮数 | `--max-turns 3` |
| `--dangerously-skip-permissions` | 跳过所有权限确认 (YOLO) | 见下方 |
| `--allowedTools` | 允许的工具列表 | `--allowedTools "Write" "Bash(git *)"` |
| `--disallowedTools` | 禁止的工具列表 | `--disallowedTools "Bash(rm *)"` |
| `--add-dir` | 添加额外工作目录 | `--add-dir ./apps ./lib` |
| `--verbose` | 启用详细日志 | `--verbose` |
| `--continue` | 继续最近对话 | `--continue` |
| `--resume` | 恢复指定会话 | `--resume abc123` |
## 可用模型
- `claude-sonnet-4` - 平衡模型 (默认)
- `claude-opus-4` - 最强模型
- `claude-opus-4.5` - 最新最强
## 无头模式用法
```bash
# Print 模式（非交互，执行后退出）
claude -p "review this code" --output-format text
# 管道输入
cat input.txt | claude -p "explain these errors"
# YOLO 模式（跳过所有权限确认）
claude --dangerously-skip-permissions "Your prompt"
# 别名设置
alias cc='claude --dangerously-skip-permissions'
# 继续对话 + Print 模式（适合脚本）
claude -c -p "show progress"
```
## 交互式命令 (Slash Commands)
| 命令 | 说明 |
|:---|:---|
| `/help` | 显示所有命令 |
| `/config` | 配置设置 |
| `/allowed-tools` | 配置工具权限 |
| `/mcp` | 管理 MCP 服务器 |
| `/vim` | 启用 vim 编辑模式 |
## 配置文件
- 用户设置: `~/.claude/settings.json`
- 项目设置: `.claude/settings.json`
- 本地设置: `.claude/settings.local.json`
```json
{
"model": "claude-sonnet-4",
"permissions": {
"allowedTools": ["Read", "Write", "Bash(git *)"],
"deny": ["Read(./.env)", "Bash(rm *)"]
}
}
```
## 上下文文件 (CLAUDE.md)
- 全局: `~/.claude/CLAUDE.md`
- 项目: `./CLAUDE.md`
- 子目录: 组件特定指令
## 深度思考触发词
强度递增：
- `think` - 基础思考
- `think hard` - 深入思考
- `think harder` - 更深入
- `ultrathink` - 最深度思考
## 常见问题
1. **权限弹窗**: 使用 `--dangerously-skip-permissions`
2. **上下文过长**: 使用 `/compact` 或 `/clear`
3. **回退更改**: 使用 `/rewind`
skills/headless-cli/references/codex-cli.md
+124
View File
@@ -0,0 +1,124 @@
# Codex CLI 参数参考
> 来源: [官方文档](https://developers.openai.com/codex/cli/reference)
## 安装
```bash
npm install -g @openai/codex
```
## 认证
```bash
# 方式 1: 浏览器 OAuth (ChatGPT 账号)
codex login
# 方式 2: API Key
printenv OPENAI_API_KEY | codex login --with-api-key
# 检查登录状态
codex login status
```
## 核心命令
| 命令 | 说明 | 示例 |
|:---|:---|:---|
| `codex` | 启动交互式 TUI | `codex` |
| `codex "prompt"` | 带提示词启动 | `codex "explain this"` |
| `codex exec` / `codex e` | 非交互模式 | `codex exec "fix bugs"` |
| `codex resume` | 恢复会话 | `codex resume --last` |
| `codex apply` / `codex a` | 应用 Cloud 任务的 diff | `codex apply TASK_ID` |
| `codex mcp` | 管理 MCP 服务器 | `codex mcp add server` |
| `codex completion` | 生成 shell 补全 | `codex completion zsh` |
## 全局参数
| 参数 | 说明 | 示例 |
|:---|:---|:---|
| `--model, -m` | 指定模型 | `-m gpt-5.5` |
| `--sandbox, -s` | 沙箱策略: `read-only`/`workspace-write`/`danger-full-access` | `-s workspace-write` |
| `--ask-for-approval, -a` | 审批模式: `untrusted`/`on-failure`/`on-request`/`never` | `-a on-failure` |
| `--full-auto` | 自动化预设 (workspace-write + on-failure) | `--full-auto` |
| `--dangerously-bypass-approvals-and-sandbox` / `--yolo` | 跳过所有审批和沙箱 | `--yolo` |
| `--search` | 启用网页搜索 | `--search` |
| `--add-dir` | 添加额外写入目录 | `--add-dir ./other` |
| `--enable` | 启用功能标志 | `--enable web_search_request` |
| `--disable` | 禁用功能标志 | `--disable feature_name` |
| `--config, -c` | 配置覆盖 | `-c model_reasoning_effort="xhigh"` |
| `--image, -i` | 附加图片 | `-i image.png` |
| `--cd, -C` | 设置工作目录 | `-C /path/to/project` |
| `--profile, -p` | 配置文件 profile | `-p my-profile` |
| `--oss` | 使用本地开源模型 (Ollama) | `--oss` |
## codex exec 专用参数
| 参数 | 说明 | 示例 |
|:---|:---|:---|
| `--json` | 输出 JSONL 格式 | `--json` |
| `--output-last-message, -o` | 保存最终消息到文件 | `-o result.txt` |
| `--output-schema` | JSON Schema 验证输出 | `--output-schema schema.json` |
| `--color` | 颜色输出: `always`/`never`/`auto` | `--color never` |
| `--skip-git-repo-check` | 允许在非 Git 目录运行 | `--skip-git-repo-check` |
## 可用模型
- `gpt-5.5` - 最新推荐模型
- `gpt-5.4` - 上一代兼容模型
- `gpt-5.2` - 旧版兼容模型
## 推理强度配置
```bash
-c model_reasoning_effort="low" # 快速
-c model_reasoning_effort="medium" # 平衡
-c model_reasoning_effort="high" # 深度
-c model_reasoning_effort="xhigh" # 最深
```
## 无头模式用法
```bash
# 非交互执行
codex exec "fix all linting errors"
# 管道输入
echo "explain this error" | codex exec -
# YOLO 模式（跳过所有确认和沙箱）
codex --yolo "Your prompt"
# 或完整写法
codex --dangerously-bypass-approvals-and-sandbox "Your prompt"
# full-auto 模式（推荐的自动化方式）
codex --full-auto "Your prompt"
# 完整 YOLO 配置别名
alias c='codex --enable web_search_request -m gpt-5.5 -c model_reasoning_effort="xhigh" --yolo'
# 恢复最近会话
codex resume --last
codex exec resume --last "continue"
```
## 配置文件
配置存储在 `~/.codex/config.toml`：
```toml
model = "gpt-5.5"
sandbox = "workspace-write"
ask_for_approval = "on-failure"
[features]
web_search_request = true
```
## 常见问题
1. **审批弹窗**: 使用 `--yolo` 或 `--full-auto`
2. **需要联网**: 使用 `--search` 或 `--enable web_search_request`
3. **推理不够深**: 使用 `-c model_reasoning_effort="high"`
4. **非 Git 目录**: 使用 `--skip-git-repo-check`
skills/headless-cli/references/gemini-cli.md
+81
View File
@@ -0,0 +1,81 @@
# Gemini CLI 参数参考
> 来源: [官方文档](https://geminicli.com/docs/get-started/configuration/)
## 安装
```bash
npm install -g @anthropic-ai/gemini-cli
```
## 认证
首次运行会引导 Google 账号登录，或设置环境变量：
```bash
export GEMINI_API_KEY="YOUR_API_KEY"
```
## 核心命令行参数
| 参数 | 说明 | 示例 |
|:---|:---|:---|
| `--model <model>` | 指定模型 | `--model gemini-2.5-flash` |
| `--yolo` | YOLO 模式，自动批准所有工具调用 | `gemini --yolo` |
| `--approval-mode <mode>` | 审批模式: `default`/`auto_edit`/`yolo` | `--approval-mode auto_edit` |
| `--allowed-tools <tools>` | 允许的工具列表（逗号分隔） | `--allowed-tools ''` (禁用所有) |
| `--output-format <format>` | 输出格式: `text`/`json`/`stream-json` | `--output-format text` |
| `--sandbox` / `-s` | 启用沙箱模式 | `gemini -s` |
| `--prompt <prompt>` / `-p` | 非交互模式，直接传入提示词 | `gemini -p "query"` |
| `--prompt-interactive <prompt>` / `-i` | 交互模式，带初始提示词 | `gemini -i "explain"` |
| `--debug` / `-d` | 启用调试模式 | `gemini -d` |
## 可用模型
- `gemini-2.5-flash` - 快速模型
- `gemini-2.5-pro` - 高级模型
- `gemini-3-flash-preview` - 最新 Flash
- `gemini-3-pro-preview` - 最新 Pro
## 无头模式用法
```bash
# 基础无头调用（管道输入）
cat input.txt | gemini -p "Your prompt" --output-format text
# 禁用工具调用（纯文本输出）
cat input.txt | gemini -p "Your prompt" --output-format text --allowed-tools ''
# YOLO 模式（跳过所有确认）
gemini --yolo "Your prompt"
# 或使用 approval-mode
gemini --approval-mode yolo "Your prompt"
```
## 配置文件
配置存储在 `~/.gemini/settings.json` 或项目 `.gemini/settings.json`：
```json
{
"security": {
"disableYoloMode": false
},
"model": {
"name": "gemini-2.5-flash"
}
}
```
## 代理配置
```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`
skills/headless-cli/references/index.md
+15
View File
@@ -0,0 +1,15 @@
# Headless CLI References
> ⚠️ CLI 参数可能随版本更新变化，请以官方文档为准
## 目录
- [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](https://github.com/google-gemini/gemini-cli)
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
- [Codex CLI](https://github.com/openai/codex)