Skip to content

refactor!: converge the repo to skills + website (Codex-executed work packages)#75

Merged
chen201724 merged 4 commits into
mainfrom
refactor/skills-only
Jul 15, 2026
Merged

refactor!: converge the repo to skills + website (Codex-executed work packages)#75
chen201724 merged 4 commits into
mainfrom
refactor/skills-only

Conversation

@chen201724

Copy link
Copy Markdown
Member

概要

按确认的改造计划执行:仓库收敛为 skills + 官网。四个工作包由 Codex (gpt-5.6-sol) 编码、Claude 设计任务卡并三段验收(边界核查 → 功能验收 → code review)。

WP-A 92686d7 — 拆除 plugin 体系(breaking)

  • 删除 plugins/.claude-plugin/shared/mcp-config/、同步脚本、CHANGELOG 空壳及 conventional-changelog 依赖
  • Claude Code 与所有客户端统一为两步安装:claude mcp add + 复制 skills/(marketplace 渠道退役,已装用户需按新方式重装)
  • Cursor / VS Code / Windsurf 配置模板内联进 AGENT-INSTALL.md

WP-B 3236e85 — skills 资产质量统一

  • license 统一 MIT(原 Apache-2.0 与仓库冲突)、compatibility 统一表述
  • description 重写为「功能 + 使用时机 + 中英文触发短语」模式(触发语取自正文 When to Use,非编造)
  • 每文件恰好 3 行 frontmatter 变更,正文零改动(已验证)

WP-C 520d018 — CI 护栏

  • 新增 scripts/validate-skills.mjs(零依赖):frontmatter 规则 + 工具引用白名单校验scripts/known-tools.json,防"skills 引用不存在工具上架"事故复发)
  • 红绿测试通过:注入未知工具名 CI 红、还原绿
  • review fixup:skills 目录缺失时优雅报错

WP-D 75da562 — 官网对齐

  • 安装区改两步安装叙事,其他客户端指向 AGENT-INSTALL.md
  • 更新区改 git pull + 覆盖复制;说明 npx 自动更新 MCP server
  • 删除 EditionTabs/ComingSoon,团队版降级为 Skills 区一行说明(判据:官网只展示当下可安装能力)
  • review fixup:复制命令补 mkdir -p

验证

  • npm run check-skills 8/8 ✅(红绿注入测试通过)
  • website tsc -b && vite build ✅ / eslint ✅ / 浏览器 DOM 断言 10/10 ✅
  • 全仓 grep 无 marketplace / plugin install / 已删路径残留 ✅
  • 每个 WP 白名单边界零越界 ✅

🤖 Generated with Claude Code

chen201724 and others added 4 commits July 15, 2026 12:18
Executed by Codex (gpt-5.6-sol), designed and reviewed by Claude.

- Delete plugins/, .claude-plugin/, shared/mcp-config/, sync-skills.mjs,
  and the empty CHANGELOG shell + conventional-changelog dep
- Claude Code installs like every other client now: claude mcp add +
  copy skills/ into ~/.claude/skills (the marketplace channel is retired)
- Inline the Cursor / VS Code / Windsurf config templates into
  AGENT-INSTALL.md; drop the sync CI step

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…-rich descriptions

Executed by Codex, designed and reviewed by Claude.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Executed by Codex (gpt-5.6-sol), designed and reviewed by Claude;
review fixup: graceful error when skills/ is missing.

Guards against the two past incident classes: frontmatter drift and
skills referencing tools that do not exist in yuque-mcp (the whitelist
lives in scripts/known-tools.json).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
… everywhere

Executed by Codex (gpt-5.6-sol), designed and reviewed by Claude;
review fixup: mkdir -p before the skills copy one-liner.

- Install section: configure yuque-mcp + copy skills/ (marketplace flow
  is gone); other clients pointed at AGENT-INSTALL.md
- Upgrade: git pull + re-copy; npx picks up MCP server updates itself
- Remove EditionTabs/ComingSoon; team edition is one hint line under
  Skills until the group tools ship
- Hero/Modules/Footer copy updated to MCP Server + Skills narrative

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Jul 15, 2026

Copy link
Copy Markdown
PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-07-15 03:51 UTC

@chen201724
chen201724 merged commit 7c5a507 into main Jul 15, 2026
2 checks passed

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 75da562a17

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread AGENT-INSTALL.md
# 2. Install the plugin — required step
claude plugin install yuque-personal@yuque
# 1. MCP server
claude mcp add yuque-mcp -- npx -y yuque-mcp --token=$YUQUE_TOKEN

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Use user scope for Claude Code MCP install

With this new two-step Claude Code path, the skills are copied to ~/.claude/skills (user-wide), but this claude mcp add uses Claude Code's default local scope. The official docs say “By default it registers the server at local scope” and to pass --scope user for all projects (https://code.claude.com/docs/en/mcp-quickstart), so anyone running the install from the cloned checkout gets globally discoverable Yuque skills that fail in other projects because the MCP tools are only registered locally; add --scope user here or make the MCP and skills both project-scoped.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant