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

feat: add headless-cli skill and meta prompts/skills

Browse Source 
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:
tukuaiai
2025-12-19 13:41:45 +08:00
parent d93279decd
commit 5d29bcf51b
11 changed files with 896 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
i18n/zh/skills/headless-cli/SKILL.md
+153
View File
@@ -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 模式有安全风险
i18n/zh/skills/headless-cli/references/claude-cli.md
+56
View File
@@ -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`
i18n/zh/skills/headless-cli/references/codex-cli.md
+61
View File
@@ -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"`
i18n/zh/skills/headless-cli/references/gemini-cli.md
+53
View File
@@ -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`
i18n/zh/skills/headless-cli/references/index.md
+13
View File
@@ -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)
i18n/zh/skills/meta-skills/SKILL.md
+139
View File
@@ -0,0 +1,139 @@
---
name: meta-skills
description: "元技能：生成和优化 Skills 的技能。用于创建新 Skill、重构现有 Skill、建立技能标准。"
---
# Meta-Skills 元技能
生成、优化和管理 Skills 的元级技能。
## When to Use This Skill
触发条件：
- 需要创建新的 Skill
- 需要重构/优化现有 Skill
- 需要建立 Skill 编写标准
- 需要验证 Skill 质量
## Not For / Boundaries
不适用于：
- 直接执行领域任务（这是领域 Skill 的职责）
- 凭空发明事实（必须基于材料）
必需输入：
- 领域材料（文档/API/代码/规范）
- 或现有 Skill 文件
## Quick Reference
### Skill 目录结构
```
skill-name/
├── SKILL.md # 必需：入口文件
├── references/ # 可选：长文档
│ └── index.md # 导航索引
├── scripts/ # 可选：辅助脚本
└── assets/ # 可选：模板/配置
```
### SKILL.md 最小模板
```markdown
---
name: skill-name
description: "[领域]能力：包含[能力1]、[能力2]。当[触发条件]时使用。"
---
# skill-name Skill
一句话说明边界和交付物。
## When to Use This Skill
触发条件：
- [触发1]
- [触发2]
## Not For / Boundaries
- [不做什么]
- [必需输入]
## Quick Reference
### 常用模式
**模式1:** 说明
```
[可直接使用的命令/代码]
```
## Examples
### Example 1
- 输入:
- 步骤:
- 预期输出:
## References
- `references/index.md`
## Maintenance
- 来源: [文档/仓库]
- 更新: YYYY-MM-DD
- 限制: [已知限制]
```
### 质量检查清单
1. `name` 匹配 `^[a-z][a-z0-9-]*$`
2. `description` 包含"做什么+何时用"
3. 有 "When to Use" 和 "Not For"
4. Quick Reference ≤ 20 个模式
5. ≥ 3 个可复现示例
6. 长内容在 `references/`
## Examples
### Example 1: 从文档创建 Skill
**输入**: 官方文档 + 代码示例
**步骤**:
1. 创建目录 `skills/<skill-name>/`
2. 编写 frontmatter `description`
3. 提取 10-20 个高频模式到 Quick Reference
4. 添加 ≥3 个端到端示例
5. 长内容移到 `references/`
### Example 2: 重构臃肿 Skill
**输入**: 现有的长 SKILL.md
**步骤**:
1. 识别模式 vs 长文解释
2. 长文移到 `references/`
3. Quick Reference 只保留可复制的模式
4. 添加 "Not For / Boundaries"
### Example 3: 验证 Skill 质量
**输入**: `skills/<skill-name>/`
**步骤**:
1. 检查 frontmatter 格式
2. 检查必需章节
3. 检查示例数量
4. 检查 references 导航
## References
- [claude-skills 元技能](../claude-skills/SKILL.md) - 完整的 Skill 规范
- [skill-template.md](./skill-template.md) - 技能模板
## Maintenance
- 来源: claude-skills 规范
- 更新: 2025-12-19
- 限制: 模板是建议性的，可根据需要调整
i18n/zh/skills/meta-skills/skill-template.md
+118
View File
@@ -0,0 +1,118 @@
# 技能规范化模板
## 元信息
- 版本: v1.0
- 更新: 2025-12-19
---
## 模板正文
```markdown
---
name: [skill-name]
description: "[领域]能力：包含[能力1]、[能力2]。当[触发条件]时使用。"
---
# [skill-name] Skill
[一句话说明边界和交付物]
## When to Use This Skill
触发条件：
- [触发条件1：具体任务/关键词]
- [触发条件2]
- [触发条件3]
## Not For / Boundaries
不适用于：
- [不做什么1]
- [不做什么2]
必需输入：
- [必需输入1]
- [必需输入2]
## Quick Reference
### [分类1]
**模式1:** [一行说明]
```
[可直接复制使用的命令/代码]
```
**模式2:** [一行说明]
```
[可直接复制使用的命令/代码]
```
### [分类2]
...
## Examples
### Example 1: [场景名称]
**输入**: [输入描述]
**步骤**:
1. [步骤1]
2. [步骤2]
3. [步骤3]
**预期输出**: [输出描述/验收标准]
### Example 2: [场景名称]
...
### Example 3: [场景名称]
...
## References
- `references/index.md` - 导航索引
- `references/[topic].md` - [主题说明]
- [外部链接](https://example.com) - [说明]
## Maintenance
- 来源: [文档/仓库/规范]
- 更新: YYYY-MM-DD
- 限制: [已知限制和边界情况]
```
---
## 使用说明
1. 复制上方模板
2. 替换 `[占位符]` 为实际内容
3. `name` 必须是小写字母+数字+连字符
4. `description` 必须包含"做什么"和"何时用"
5. 至少提供 3 个示例
## 目录结构
```
skill-name/
├── SKILL.md # 必需
├── references/ # 可选
│ ├── index.md # 推荐
│ └── [topic].md
├── scripts/ # 可选
└── assets/ # 可选
```
## 质量检查
- [ ] name 格式正确
- [ ] description 包含触发关键词
- [ ] 有 When to Use
- [ ] 有 Not For / Boundaries
- [ ] Quick Reference ≤ 20 模式
- [ ] ≥ 3 个示例
- [ ] 长内容在 references/