resumes-cli

Other Community

Repo stars 19
Author repo openmemory-plus

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: | 主题 | 风格 | GitHub Stars | |------|------|-------------| | elegant | 优雅专业 (默认) | ⭐ 126 | | stackoverflow | Stack Overflow 风格 | ⭐…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “Triggers”, “Capabilities”, “Available Themes”, “使用前检查 (Agent 必读)”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name resumes-cli directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “Triggers / Capabilities / Available Themes” before expanding.

Boundaries And Review

Dependencies: It usually needs no extra API key, so start with a small validation task.
Permissions: Declared permissions include read; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

resumes-cli Skill

Triggers

User mentions "resumes-cli", "简历CLI", "resume tool"
User wants to sync documents from Yuque (语雀)
User wants to validate or export resume
User wants to preview resume with themes
Keywords: 简历导出, 语雀同步, resume export, yuque sync, 主题渲染

Capabilities

语雀同步: 从语雀同步项目文档到本地
简历验证: 验证简历 JSON 格式是否符合 JSON Resume 标准
主题渲染: 使用 json-resume 主题导出精美 HTML
本地预览: 实时预览简历效果
批量导出: 一键导出所有主题风格
工作流: 一键执行完整流程 (sync → validate → export)

Available Themes

全部支持 projects 字段渲染

主题	风格	GitHub Stars
`elegant`	优雅专业 (默认)	⭐ 126
`stackoverflow`	Stack Overflow 风格	⭐ 154
`kendall`	经典传统	⭐ 68
`macchiato`	咖啡色调	⭐ 18
`github`	GitHub Primer 风格	⭐ 17
`actual`	现代简约	-

使用前检查 (Agent 必读)

每次使用前必须先检查 CLI 是否可用：

# 1. 检查是否已全局安装
which resumes-cli

# 2. 如果返回路径 (如 /opt/homebrew/bin/resumes-cli)，直接使用
# 3. 如果返回空或 "not found"，先安装：
cd _bmad-output/bmb-creations/cli/resumes-cli && npm run build && npm link

# 4. 安装后回到项目根目录使用
cd /Users/ryuichi/Documents/Projects/resumes
resumes-cli --version

⚠️ 禁止行为： 不要 cd 到源码目录用 npx ts-node 运行，应该全局安装后直接使用 resumes-cli 命令。

Quick Reference

# 初始化配置
resumes-cli config init

# 语雀同步
resumes-cli yuque sync --json

# 验证简历
resumes-cli resume validate --file ./resume/resume.json

# 导出简历 (使用主题)
resumes-cli resume export --theme elegant --output ./resume.html

# 导出所有主题
resumes-cli resume export-all --file ./resume/resume.json

# 本地预览
resumes-cli resume serve --theme elegant --port 4000

# 一键执行完整流程
resumes-cli workflow run --skip-sync --theme elegant

Command Groups

命令组	描述
`config`	配置管理 (init, show)
`yuque`	语雀同步 (sync, status, schedule)
`resume`	简历管理 (validate, export, export-all, serve)
`workflow`	工作流 (run)

Global Options

--json - JSON 格式输出 (AI Agent 友好)
--verbose - 详细输出
--help - 显示帮助

Exit Codes

代码	含义
0	成功
1	错误
2	配置错误/警告

@resumes-cli/README.md - 完整文档
@.augment/commands/resumes-cli.md - 命令参考

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: Other
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 88 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @Alenryuichi · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Plug-and-play
External API key: No requirement detected
Detected OS requirements: macOS · Linux · Windows
Runtime requirements: Node.js
Detected file/system behavior: Read-only
Detected network behavior: Local-only
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview resumes-cli.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# resumes-cli Skill

## Triggers

- User mentions "resumes-cli", "简历CLI", "resume tool"
- User wants to sync documents from Yuque (语雀)
- User wants to validate or export resume
- User wants to preview resume with themes
- Keywords: 简历导出, 语雀同步, resume export, yuque sync, 主题渲染

## Capabilities

- **语雀同步**: 从语雀同步项目文档到本地
- **简历验证**: 验证简历 JSON 格式是否符合 JSON Resume 标准
- **主题渲染**: 使用 json-resume 主题导出精美 HTML
- **本地预览**: 实时预览简历效果
- **批量导出**: 一键导出所有主题风格
- **工作流**: 一键执行完整流程 (sync → validate → export)

## Available Themes

> 全部支持 projects 字段渲染

| 主题 | 风格 | GitHub Stars |
|------|------|-------------|
| `elegant` | 优雅专业 (默认) | ⭐ 126 |
| `stackoverflow` | Stack Overflow 风格 | ⭐ 154 |
| `kendall` | 经典传统 | ⭐ 68 |
| `macchiato` | 咖啡色调 | ⭐ 18 |
| `github` | GitHub Primer 风格 | ⭐ 17 |
| `actual` | 现代简约 | - |

## 使用前检查 (Agent 必读)

**每次使用前必须先检查 CLI 是否可用：**

```bash
# 1. 检查是否已全局安装
which resumes-cli

# 2. 如果返回路径 (如 /opt/homebrew/bin/resumes-cli)，直接使用
# 3. 如果返回空或 "not found"，先安装：
cd _bmad-output/bmb-creations/cli/resumes-cli && npm run build && npm link

# 4. 安装后回到项目根目录使用
cd /Users/ryuichi/Documents/Projects/resumes
resumes-cli --version
```

⚠️ **禁止行为：** 不要 cd 到源码目录用 `npx ts-node` 运行，应该全局安装后直接使用 `resumes-cli` 命令。

## Quick Reference

```bash
# 初始化配置
resumes-cli config init

# 语雀同步
resumes-cli yuque sync --json

# 验证简历
resumes-cli resume validate --file ./resume/resume.json

# 导出简历 (使用主题)
resumes-cli resume export --theme elegant --output ./resume.html

# 导出所有主题
resumes-cli resume export-all --file ./resume/resume.json

# 本地预览
resumes-cli resume serve --theme elegant --port 4000

# 一键执行完整流程
resumes-cli workflow run --skip-sync --theme elegant
```

## Command Groups

| 命令组 | 描述 |
|--------|------|
| `config` | 配置管理 (init, show) |
| `yuque` | 语雀同步 (sync, status, schedule) |

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> Triggers → Capabilities → Available Themes → 使用前检查 (Agent 必读) → Quick Reference → Command Groups
terms    -> 语雀同步 · 简历验证 · 主题渲染 · 本地预览 · 批量导出 · 工作流 · 每次使用前必须先检查 CLI 是否可用 · 禁止行为
files/cmd -> elegant · stackoverflow · kendall · macchiato · actual · npx ts-node · resumes-cli · config
body sha256 -> 579ba19a3abc