fix: resolve website issues - deprecated tools, broken links, missing install guides (#63)

* fix: resolve website issues #59, #61, #62

- Fix Feature Request link 404 (#61): Replace broken Discussions links
  in issue template config with a proper feature_request.yml template,
  since Discussions is not enabled on this repo.

- Remove deprecated tools from website (#59): Update MCP tools list
  from 20 to 16 tools to match current yuque-mcp-server. Removed
  yuque_list_groups, yuque_hello, yuque_list_doc_versions,
  yuque_get_doc_version. Renamed repos→books to match API naming.

- Add Claude Code and Codex install guides (#62): Add Claude Code
  (direct MCP config via `claude mcp add`) and OpenAI Codex
  (`codex mcp add` + config.toml) as client options in Quick Start.

* fix: update tool names in all SKILL.md files

- yuque_list_repos → yuque_list_books
- yuque_get_repo → yuque_get_book
- yuque_get_repo_docs → yuque_list_docs
- Updated across yuque-personal, yuque-group, openclaw, and opencode skills

* fix: replace outdated 25-tool table with correct 16 tools in docs

- Updated AGENT-INSTALL.md for claude-code, opencode, shared/mcp-config
- Updated opencode README.md and README.en.md
- Removed references to deleted tools (delete_doc, doc_history, groups,
  comments, statistics)
- New categories: User, Search, Books, Docs, TOC, Notes

* docs: sync tool count from 25 to 16 and fix skill count in descriptions

- 25 MCP Tools → 16 MCP Tools everywhere
- 25 Tools → 16 Tools in directory comments
- Fix personal plugin skill count: 4 Skills → 8 Skills
- Updated marketplace.json, plugin.json, READMEs

* fix: update website components — tool count, skill tags, and links

- Modules.tsx: 25 → 16 tools count
- Skills.tsx: get_repo_docs → list_docs in skill tags
- Skills.tsx: fix broken GitHub links (claude-code/personal → yuque-personal)

---------

Co-authored-by: babydog-ai <willchen.babydog@gmail.com>

Author: chen201724

.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "yuque-personal",
-      "description": "语雀个人版 — 个人知识库 AI 集成，25 MCP Tools + 4 Skills",
+      "description": "语雀个人版 — 个人知识库 AI 集成，16 MCP Tools + 8 Skills",
       "version": "1.0.0",
       "author": {
         "name": "yuque"
@@ -20,7 +20,7 @@
     },
     {
       "name": "yuque-group",
-      "description": "语雀团队版 — 团队知识库 AI 集成，25 MCP Tools + 6 Skills",
+      "description": "语雀团队版 — 团队知识库 AI 集成，16 MCP Tools + 6 Skills",
       "version": "1.0.0",
       "author": {
         "name": "yuque"

.github/ISSUE_TEMPLATE/config.yml

@@ -1,8 +1,5 @@
 blank_issues_enabled: false
 contact_links:
   - name: Questions
-    url: https://github.com/yuque/yuque-ecosystem/discussions/categories/q-a
+    url: https://github.com/yuque/yuque-ecosystem/issues
     about: Ask questions and get help from the community.
-  - name: Feature Requests
-    url: https://github.com/yuque/yuque-ecosystem/discussions/categories/ideas
-    about: Suggest new features or improvements.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,50 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: dropdown
+    id: area
+    attributes:
+      label: Affected Area
+      description: Which part of the ecosystem would this feature apply to?
+      options:
+        - MCP Server (yuque-mcp)
+        - Website
+        - Claude Code Plugin
+        - OpenClaw Plugin
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve? Is it related to a frustration?
+      placeholder: I'm always frustrated when...
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe the solution you'd like.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any alternative solutions or features you've considered?
+    validations:
+      required: false
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Any other context, screenshots, or references?
+    validations:
+      required: false

README.en.md

@@ -25,11 +25,11 @@ yuque-ecosystem/
 ├── website/                  # Official website (GitHub Pages)
 ├── plugins/
 │   ├── claude-code/          # Claude Code Plugin (Marketplace)
-│   │   ├── personal/         # Personal edition — 25 Tools + 8 Skills
-│   │   └── group/            # Team edition — 25 Tools + 6 Skills
+│   │   ├── personal/         # Personal edition — 16 Tools + 8 Skills
+│   │   └── group/            # Team edition — 16 Tools + 6 Skills
 │   ├── opencode/             # OpenCode Plugin (MCP + Skills)
-│   │   ├── personal/         # Personal edition — 25 Tools + 8 Skills
-│   │   └── group/            # Team edition — 25 Tools + 6 Skills
+│   │   ├── personal/         # Personal edition — 16 Tools + 8 Skills
+│   │   └── group/            # Team edition — 16 Tools + 6 Skills
 │   └── openclaw/             # OpenClaw Plugin (Agent Skills)
 ├── shared/
 │   └── mcp-config/           # MCP config templates for various editors

README.md

@@ -25,11 +25,11 @@ yuque-ecosystem/
 ├── website/                  # Official website (GitHub Pages)
 ├── plugins/
 │   ├── claude-code/          # Claude Code Plugin (Marketplace)
-│   │   ├── personal/         # Personal edition — 25 Tools + 8 Skills
-│   │   └── group/            # Team edition — 25 Tools + 6 Skills
+│   │   ├── personal/         # Personal edition — 16 Tools + 8 Skills
+│   │   └── group/            # Team edition — 16 Tools + 6 Skills
 │   ├── opencode/             # OpenCode Plugin (MCP + Skills)
-│   │   ├── personal/         # Personal edition — 25 Tools + 8 Skills
-│   │   └── group/            # Team edition — 25 Tools + 6 Skills
+│   │   ├── personal/         # Personal edition — 16 Tools + 8 Skills
+│   │   └── group/            # Team edition — 16 Tools + 6 Skills
 │   └── openclaw/             # OpenClaw Plugin (Agent Skills)
 ├── shared/
 │   └── mcp-config/           # MCP config templates for various editors

plugins/claude-code/.claude-plugin/marketplace.json

@@ -13,7 +13,7 @@
   "plugins": [
     {
       "name": "yuque-personal",
-      "description": "语雀个人版 — 个人知识库 AI 集成，25 MCP Tools + 4 Skills",
+      "description": "语雀个人版 — 个人知识库 AI 集成，16 MCP Tools + 8 Skills",
       "version": "1.0.0",
       "author": {
         "name": "yuque"
@@ -23,7 +23,7 @@
     },
     {
       "name": "yuque-group",
-      "description": "语雀团队版 — 团队知识库 AI 集成，25 MCP Tools + 6 Skills",
+      "description": "语雀团队版 — 团队知识库 AI 集成，16 MCP Tools + 6 Skills",
       "version": "1.0.0",
       "author": {
         "name": "yuque"

plugins/claude-code/AGENT-INSTALL.md

@@ -60,7 +60,7 @@ export YUQUE_TOKEN="your_token_here"
 
 ## Installation Method 2: MCP Server Only
 
-Use this if you only need the 25 MCP tools without skills, or if the marketplace is unavailable.
+Use this if you only need the 16 MCP tools without skills, or if the marketplace is unavailable.
 
 ### Install
 
@@ -93,7 +93,7 @@ After either installation method, verify the integration is working:
 ```bash
 claude mcp list
 # Look for "yuque-mcp" in the output
-# Should show ~25 tools available
+# Should show ~16 tools available
 ```
 
 ### Test 2: Quick Functional Test
@@ -126,15 +126,16 @@ cd /path/to/yuque-ecosystem
 
 ## Available After Installation
 
-### MCP Tools (25)
+### MCP Tools (16)
 
 | Category | Tools |
 |----------|-------|
-| Document Management | `yuque_search`, `yuque_get_doc`, `yuque_create_doc`, `yuque_update_doc`, `yuque_delete_doc`, `yuque_get_doc_history` |
-| Knowledge Base | `yuque_list_repos`, `yuque_get_repo`, `yuque_create_repo`, `yuque_update_repo`, `yuque_delete_repo`, `yuque_get_toc` |
-| User & Group | `yuque_get_user`, `yuque_list_groups`, `yuque_get_group`, `yuque_list_group_repos` |
-| Collaboration | `yuque_list_comments`, `yuque_create_comment`, `yuque_delete_comment` |
-| Statistics | `yuque_get_doc_stats`, `yuque_get_repo_stats`, `yuque_get_group_stats`, `yuque_get_group_member_stats`, `yuque_get_trending_docs`, `yuque_get_active_members` |
+| User | `yuque_get_user` |
+| Search | `yuque_search` |
+| Books (知识库) | `yuque_list_books`, `yuque_get_book`, `yuque_create_book`, `yuque_update_book` |
+| Docs | `yuque_list_docs`, `yuque_get_doc`, `yuque_create_doc`, `yuque_update_doc` |
+| TOC | `yuque_get_toc`, `yuque_update_toc` |
+| Notes (小记) | `yuque_list_notes`, `yuque_get_note`, `yuque_create_note`, `yuque_update_note` |
 
 ### Skills (Marketplace install only)
 

plugins/claude-code/README.en.md

@@ -8,13 +8,13 @@
 
 ### Personal
 
-AI-powered personal knowledge base integration — 25 MCP Tools + 8 Skills.
+AI-powered personal knowledge base integration — 16 MCP Tools + 8 Skills.
 
 📂 [`../yuque-personal/`](../yuque-personal/)
 
 ### Group (Team)
 
-AI-powered team knowledge base integration — 25 MCP Tools + 6 Skills.
+AI-powered team knowledge base integration — 16 MCP Tools + 6 Skills.
 
 📂 [`../yuque-group/`](../yuque-group/)
 

plugins/claude-code/README.md

@@ -8,13 +8,13 @@
 
 ### Personal (个人版)
 
-Personal knowledge base AI integration — 25 MCP Tools + 8 Skills.
+Personal knowledge base AI integration — 16 MCP Tools + 8 Skills.
 
 📂 [`../yuque-personal/`](../yuque-personal/)
 
 ### Group (团队版)
 
-Team knowledge base AI integration — 25 MCP Tools + 6 Skills.
+Team knowledge base AI integration — 16 MCP Tools + 6 Skills.
 
 📂 [`../yuque-group/`](../yuque-group/)
 

plugins/openclaw/skills/daily-capture/SKILL.md

@@ -27,7 +27,7 @@ All tools are from the `yuque-mcp` server:
 - `yuque_get_doc` — Read existing capture log or thematic notes
 - `yuque_create_doc` — Create new capture log or thematic notes
 - `yuque_update_doc` — Append to capture log or update thematic notes
-- `yuque_list_repos` — List knowledge bases to find the target repo
+- `yuque_list_books` — List knowledge bases to find the target repo
 
 ## Workflow
 
@@ -209,7 +209,7 @@ Confirm: "主题笔记「[主题标题]」已保存到「[知识库名称]」：
 |-----------|--------|
 | Document not found (404) | Create a new capture log for today |
 | Permission denied (403) | Tell user they may lack permission to access or edit this document |
-| Target repo not found | List user's repos with `yuque_list_repos` and ask them to pick one |
+| Target repo not found | List user's repos with `yuque_list_books` and ask them to pick one |
 | `yuque_create_doc` fails | Present the capture/note in chat and suggest manual saving |
 | No captures found for organization | Inform user: "最近没有找到碎片记录，先随手记几条吧！" |
 | Capture content is empty | Ask user: "你想记录什么？" |