From bb7b8453e252f97c72aa42283c50a6b4e1c350e6 Mon Sep 17 00:00:00 2001 From: jilinchen Date: Thu, 8 Jan 2026 11:30:50 +0800 Subject: [PATCH] refactor: flatten skills directory structure - Restructure skills/research-zh and skills/research-en to flat layout - Each skill now in its own directory (research, research-deep, etc.) - Update installation: cp -r skills/research-zh/* ~/.claude/skills/ - Update command references from /research:deep to /research-deep Co-Authored-By: Claude Opus 4.5 --- README.md | 29 +++++++++---------- README.zh.md | 29 +++++++++---------- .../SKILL.md | 0 .../SKILL.md | 0 .../{deep => research-deep}/SKILL.md | 0 .../{report => research-report}/SKILL.md | 0 skills/research-en/{ => research}/SKILL.md | 0 .../{ => research}/validate_json.py | 0 .../SKILL.md | 0 .../SKILL.md | 0 .../{deep => research-deep}/SKILL.md | 0 .../{report => research-report}/SKILL.md | 0 skills/research-zh/{ => research}/SKILL.md | 0 .../{ => research}/validate_json.py | 0 14 files changed, 26 insertions(+), 32 deletions(-) rename skills/research-en/{add-fields => research-add-fields}/SKILL.md (100%) rename skills/research-en/{add-items => research-add-items}/SKILL.md (100%) rename skills/research-en/{deep => research-deep}/SKILL.md (100%) rename skills/research-en/{report => research-report}/SKILL.md (100%) rename skills/research-en/{ => research}/SKILL.md (100%) rename skills/research-en/{ => research}/validate_json.py (100%) rename skills/research-zh/{add-fields => research-add-fields}/SKILL.md (100%) rename skills/research-zh/{add-items => research-add-items}/SKILL.md (100%) rename skills/research-zh/{deep => research-deep}/SKILL.md (100%) rename skills/research-zh/{report => research-report}/SKILL.md (100%) rename skills/research-zh/{ => research}/SKILL.md (100%) rename skills/research-zh/{ => research}/validate_json.py (100%) diff --git a/README.md b/README.md index 80351dd..a4169cd 100644 --- a/README.md +++ b/README.md @@ -17,10 +17,10 @@ A structured research workflow skill for Claude Code, supporting two-phase resea ```bash # English version -cp -r skills/research-en ~/.claude/skills/research +cp -r skills/research-en/* ~/.claude/skills/ # Chinese version -cp -r skills/research-zh ~/.claude/skills/research +cp -r skills/research-zh/* ~/.claude/skills/ # Required: Install agent cp agents/web-search-agent.md ~/.claude/agents/ @@ -31,17 +31,17 @@ pip install pyyaml ## Commands -> **Claude Code 2.1.0+**: Direct `/research` trigger is now supported! +> **Claude Code 2.1.0+**: Direct `/skill-name` trigger is now supported! > -> **Older versions**: Use `run /research` format instead. +> **Older versions**: Use `run /skill-name` format instead. -| Command (2.1.0+) | Command (older) | Description | -|------------------|-----------------|-------------| -| `/research` | `run /research` | Generate research outline with items and fields | -| `/research:add-items` | `run /research/add-items` | Add more items to existing outline | -| `/research:add-fields` | `run /research/add-fields` | Add more fields to existing outline | -| `/research:deep` | `run /research/deep` | Deep research each item with parallel agents | -| `/research:report` | `run /research/report` | Generate markdown report from JSON results | +| Command (2.1.0+) | Description | +|------------------|-------------| +| `/research` | Generate research outline with items and fields | +| `/research-add-items` | Add more items to existing outline | +| `/research-add-fields` | Add more fields to existing outline | +| `/research-deep` | Deep research each item with parallel agents | +| `/research-report` | Generate markdown report from JSON results | ## Workflow & Example @@ -51,25 +51,22 @@ pip install pyyaml ``` /research AI Agent Demo 2025 ``` -> *Older versions: `run /research AI Agent Demo 2025`* 💡 **What happens**: Tell it your topic → It creates a research list for you **You get**: A list of 17 AI Agents to research (ChatGPT Agent, Claude Computer Use, Cursor, etc.) + what info to collect for each ### Phase 2: Deep Research ``` -/research:deep +/research-deep ``` -> *Older versions: `run /research/deep`* 💡 **What happens**: AI automatically searches the web for each item, one by one **You get**: Detailed info for each Agent (company, release date, pricing, tech specs, reviews...) ### Phase 3: Generate Report ``` -/research:report +/research-report ``` -> *Older versions: `run /research/report`* 💡 **What happens**: All data → One organized report **You get**: `report.md` - A complete markdown report with table of contents, ready to read or share diff --git a/README.zh.md b/README.zh.md index e6a5c70..8b7d6f4 100644 --- a/README.zh.md +++ b/README.zh.md @@ -17,10 +17,10 @@ Claude Code 的结构化调研工作流技能，支持两阶段调研：outline ```bash # 中文版 -cp -r skills/research-zh ~/.claude/skills/research +cp -r skills/research-zh/* ~/.claude/skills/ # 英文版 -cp -r skills/research-en ~/.claude/skills/research +cp -r skills/research-en/* ~/.claude/skills/ # 必需：安装agent cp agents/web-search-agent.md ~/.claude/agents/ @@ -31,17 +31,17 @@ pip install pyyaml ## 命令 -> **Claude Code 2.1.0+**：现已支持直接 `/research` 触发！ +> **Claude Code 2.1.0+**：现已支持直接 `/skill-name` 触发！ > -> **旧版本**：请使用 `run /research` 格式。 +> **旧版本**：请使用 `run /skill-name` 格式。 -| 命令 (2.1.0+) | 命令 (旧版本) | 描述 | -|---------------|---------------|------| -| `/research` | `run /research` | 生成包含items和fields的调研outline | -| `/research:add-items` | `run /research/add-items` | 向现有outline添加更多items | -| `/research:add-fields` | `run /research/add-fields` | 向现有outline添加更多fields | -| `/research:deep` | `run /research/deep` | 使用并行agents对每个item进行深度调研 | -| `/research:report` | `run /research/report` | 从JSON结果生成markdown报告 | +| 命令 (2.1.0+) | 描述 | +|---------------|------| +| `/research` | 生成包含items和fields的调研outline | +| `/research-add-items` | 向现有outline添加更多items | +| `/research-add-fields` | 向现有outline添加更多fields | +| `/research-deep` | 使用并行agents对每个item进行深度调研 | +| `/research-report` | 从JSON结果生成markdown报告 | ## 工作流 & 示例 @@ -51,25 +51,22 @@ pip install pyyaml ``` /research AI Agent Demo 2025 ``` -> *旧版本: `run /research AI Agent Demo 2025`* 💡 **发生了什么**：告诉它你要研究什么 → 它帮你列出调研清单 **你会得到**：17个待调研的AI Agent清单（ChatGPT Agent、Claude Computer Use、Cursor等）+ 每个要收集哪些信息 ### 阶段2：深度调研 ``` -/research:deep +/research-deep ``` -> *旧版本: `run /research/deep`* 💡 **发生了什么**：AI自动上网搜索每个item的详细信息，逐个完成 **你会得到**：每个Agent的详细资料（公司、发布日期、定价、技术规格、用户评价...） ### 阶段3：生成报告 ``` -/research:report +/research-report ``` -> *旧版本: `run /research/report`* 💡 **发生了什么**：所有数据 → 一份整理好的报告 **你会得到**：`report.md` - 带目录的完整Markdown报告，可直接阅读或分享 diff --git a/skills/research-en/add-fields/SKILL.md b/skills/research-en/research-add-fields/SKILL.md similarity index 100% rename from skills/research-en/add-fields/SKILL.md rename to skills/research-en/research-add-fields/SKILL.md diff --git a/skills/research-en/add-items/SKILL.md b/skills/research-en/research-add-items/SKILL.md similarity index 100% rename from skills/research-en/add-items/SKILL.md rename to skills/research-en/research-add-items/SKILL.md diff --git a/skills/research-en/deep/SKILL.md b/skills/research-en/research-deep/SKILL.md similarity index 100% rename from skills/research-en/deep/SKILL.md rename to skills/research-en/research-deep/SKILL.md diff --git a/skills/research-en/report/SKILL.md b/skills/research-en/research-report/SKILL.md similarity index 100% rename from skills/research-en/report/SKILL.md rename to skills/research-en/research-report/SKILL.md diff --git a/skills/research-en/SKILL.md b/skills/research-en/research/SKILL.md similarity index 100% rename from skills/research-en/SKILL.md rename to skills/research-en/research/SKILL.md diff --git a/skills/research-en/validate_json.py b/skills/research-en/research/validate_json.py similarity index 100% rename from skills/research-en/validate_json.py rename to skills/research-en/research/validate_json.py diff --git a/skills/research-zh/add-fields/SKILL.md b/skills/research-zh/research-add-fields/SKILL.md similarity index 100% rename from skills/research-zh/add-fields/SKILL.md rename to skills/research-zh/research-add-fields/SKILL.md diff --git a/skills/research-zh/add-items/SKILL.md b/skills/research-zh/research-add-items/SKILL.md similarity index 100% rename from skills/research-zh/add-items/SKILL.md rename to skills/research-zh/research-add-items/SKILL.md diff --git a/skills/research-zh/deep/SKILL.md b/skills/research-zh/research-deep/SKILL.md similarity index 100% rename from skills/research-zh/deep/SKILL.md rename to skills/research-zh/research-deep/SKILL.md diff --git a/skills/research-zh/report/SKILL.md b/skills/research-zh/research-report/SKILL.md similarity index 100% rename from skills/research-zh/report/SKILL.md rename to skills/research-zh/research-report/SKILL.md diff --git a/skills/research-zh/SKILL.md b/skills/research-zh/research/SKILL.md similarity index 100% rename from skills/research-zh/SKILL.md rename to skills/research-zh/research/SKILL.md diff --git a/skills/research-zh/validate_json.py b/skills/research-zh/research/validate_json.py similarity index 100% rename from skills/research-zh/validate_json.py rename to skills/research-zh/research/validate_json.py