Skip to content

Commit a4c3544

Browse files
pijiang3pijiang3
committed
add skills
1 parent 377d817 commit a4c3544

3 files changed

Lines changed: 81 additions & 9 deletions

File tree

‎.cursor/skills/fc-skills/SKILL.md‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
name: fc-skills
3+
description: Applies Flashcat development workflows from the fc-skills skill pack (session summary, git sync, migration checklist, Apifox sync, Mermaid workflow docs, doc-review vs source repos). Resolves instructions by reading SKILL.md files under FC_SKILLS_ROOT. Use when the user mentions fc-skills, Flashcat workflows, or any of the named workflows (done, summary-branch, sync-branch, sync-dev, migration-checklist, apifox-sync, workflow-doc, doc-review), or when matching Claude Code slash-command behavior in Cursor.
4+
---
5+
6+
# fc-skills (Cursor)
7+
8+
Use the **fc-skills** repository as the source of truth for workflow steps. Do not paraphrase long procedures from memory — read the corresponding `SKILL.md` and follow it.
9+
10+
## Resolve skill root
11+
12+
1. If environment variable `FC_SKILLS_ROOT` is set, use it as the absolute path to the `fc-skills` repo root.
13+
2. Otherwise try `~/go/src/github.com/flashcatcloud/fc-skills`.
14+
3. If that path does not exist, tell the user to clone `flashcatcloud/fc-skills` and set `FC_SKILLS_ROOT`, or report the missing path and stop.
15+
16+
## Route to the right SKILL.md
17+
18+
| User intent | Read and follow |
19+
|-------------|-----------------|
20+
| End session summary, `/done` | `skills/done/SKILL.md` |
21+
| Summarize branch vs base | `skills/summary-branch/SKILL.md` |
22+
| Commit + push current branch only | `skills/sync-branch/SKILL.md` |
23+
| Commit, push, merge to `dev`, push | `skills/sync-dev/SKILL.md` |
24+
| Production migration checklist from diff | `skills/migration-checklist/SKILL.md` |
25+
| Sync Apifox / OpenAPI vs code | `skills/apifox-sync/SKILL.md` |
26+
| Generate Mermaid workflow doc | `skills/workflow-doc/SKILL.md` |
27+
| Doc drift / coverage / fix docs | `skills/doc-review/SKILL.md` |
28+
29+
For a full path table and file list (e.g. `doc-review` `analyze.md`, `fix.md`), see [reference.md](reference.md).
30+
31+
## Execution rules
32+
33+
1. **Read first:** `Read` the target `SKILL.md` under `FC_SKILLS_ROOT` before running commands.
34+
2. **Sub-resources:** If that SKILL points to sibling files (e.g. `analyze.md`, `fix.md`, `mapping.yaml`), read them from the same skill directory under `fc-skills`.
35+
3. **Git:** `sync-branch` and `sync-dev` require `git_write` permission when executing. Never force-push unless the user explicitly orders it and the project allows it (fc-skills default: never force push).
36+
4. **doc-review:** Use `skills/doc-review/mapping.yaml` from the clone — not `.claude/skills/...` (that path is for the Claude Code plugin install).
37+
5. **Apifox:** Follow `apifox-sync` only when Apifox MCP or equivalent tools are available; otherwise state the prerequisite and stop.
38+
39+
## Quick argument hints
40+
41+
- Pass through optional user arguments (commit message, base branch, `/doc-review` flags) exactly as the upstream SKILL describes.
42+
- If the user names a skill ambiguously, prefer the table above and confirm once if two workflows could match.

‎.cursor/skills/fc-skills/reference.md‎

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
# fc-skills reference for Cursor
2+
3+
## Repository
4+
5+
- **Remote:** `github.com/flashcatcloud/fc-skills` (Claude Code plugin; same skills apply in Cursor.)
6+
- **Default local clone:** `~/go/src/github.com/flashcatcloud/fc-skills`
7+
- **Override:** set `FC_SKILLS_ROOT` to the absolute path of your clone if it differs.
8+
9+
## Skill index → SKILL.md path
10+
11+
| Skill | Relative path under `FC_SKILLS_ROOT` |
12+
|-------|--------------------------------------|
13+
| done | `skills/done/SKILL.md` |
14+
| summary-branch | `skills/summary-branch/SKILL.md` |
15+
| sync-branch | `skills/sync-branch/SKILL.md` |
16+
| sync-dev | `skills/sync-dev/SKILL.md` |
17+
| migration-checklist | `skills/migration-checklist/SKILL.md` |
18+
| apifox-sync | `skills/apifox-sync/SKILL.md` |
19+
| workflow-doc | `skills/workflow-doc/SKILL.md` |
20+
| doc-review | `skills/doc-review/SKILL.md` |
21+
22+
## doc-review extra files
23+
24+
Under `skills/doc-review/`:
25+
26+
- `mapping.yaml` — module ↔ repo path mapping (`base_path` rules in SKILL.md)
27+
- `analyze.md` — Phase 1 (Analyze)
28+
- `fix.md` — Phase 2 (Fix)
29+
- `prompts/diff.md`, `prompts/audit.md` — prompt templates
30+
31+
## Claude vs Cursor differences
32+
33+
- **Install:** Claude uses `/plugin install fc-skills@fc-skills`. Cursor reads the same skill tree from a local clone (or copy) under `FC_SKILLS_ROOT`.
34+
- **done output path:** Original uses `~/.claude/sessions/`. Keep that path unless the user asks otherwise; create `~/.claude/sessions` if missing.
35+
- **doc-review:** In the cloned repo, mapping is `skills/doc-review/mapping.yaml`, not `.claude/skills/doc-review/mapping.yaml` (that path is for the plugin install layout).
36+
37+
## Plugin metadata (for humans)
38+
39+
See `fc-skills/.claude-plugin/plugin.json` for plugin name and version.

‎AGENTS.md‎

Lines changed: 0 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -14,15 +14,6 @@ flashduty-docs/
1414
├── en/ # English documentation (mirrors zh/ structure)
1515
├── logo/ # Logo assets
1616
├── docs.json # Mintlify configuration
17-
└── .cursor/
18-
└── skills/ # Agent Skills
19-
├── translate-zh-to-en/ # Translation skill
20-
│ ├── SKILL.md # Translation guide
21-
│ └── glossary.md # Terminology glossary
22-
└── polish-document/ # Polishing skill
23-
├── SKILL.md # Polishing guide
24-
├── standards.md # Writing standards
25-
└── components.md # Component reference
2617
```
2718

2819
## Available Skills

0 commit comments

Comments
 (0)