Skip to content

refactor!: official positioning — skills as the core asset, single install guide#74

Merged
chen201724 merged 2 commits into
mainfrom
docs/official-positioning
Jul 15, 2026
Merged

refactor!: official positioning — skills as the core asset, single install guide#74
chen201724 merged 2 commits into
mainfrom
docs/official-positioning

Conversation

@chen201724

Copy link
Copy Markdown
Member

概要

确立官方定位并按定位重构仓库:skills 是资产,客户端接入是分发,官网是门面

Commit 1 — 官方定位落地(docs)

  • README(中英):删除 "Stripe-style monorepo" 类比,改为资产/分发/门面四层定位表 + 与 yuque-mcp-server 的能力/体验边界
  • marketplace.json:移除个人邮箱(schema 允许仅 owner.name,已过 claude plugin validate
  • skills frontmatter 署名统一为 yuque(个人贡献保留在 git 历史)
  • 官网 Hero/meta 标注「语雀 AI 集成官方分发中心」「官方开源」

Commit 2 — 围绕 skills 重构(breaking)

核心判断:SKILL.md 是跨客户端通用格式,agent 拿到仓库即可自行安装,按客户端复制目录是纯冗余。

  • skills/ 提升为仓库根目录唯一源,第一屏可见
  • 删除 plugins/openclaw/(npm 包未发布 + 空壳 index.ts + skills 副本)、plugins/opencode/(skills 副本 + 文档)、plugins/claude-code/(纯文档目录)
  • 保留唯一正式打包渠道:plugins/yuque-personal/(Claude Code Marketplace 强制目录结构,存量安装的更新链路不受影响;skills 为同步副本,CI 校验漂移)
  • 三份 AGENT-INSTALL 合并为根目录一份,覆盖 Claude Code / OpenCode / OpenClaw / Cursor / VS Code / Windsurf / 通用 agent
  • 同步脚本反向:skills/ → 插件目录;npm workspaces 移除 openclaw
  • 官网 Modules 文案改为能力层/资产层/分发层表述,skills 链接与 Footer 指向新路径

验证

  • claude plugin validate(marketplace + plugin)✅
  • node scripts/sync-skills.mjs --check
  • 全仓 JSON parse ✅
  • website tsc -b && vite build ✅ / eslint ✅ / DOM 内容与控制台无错 ✅
  • 无残留指向已删目录的链接(全仓 grep)✅

🤖 Generated with Claude Code

chen201724 and others added 2 commits July 15, 2026 11:50
- README (zh/en): replace the 'Stripe-style monorepo' framing with the
  asset/distribution/storefront positioning and the capability-vs-
  experience boundary against yuque-mcp-server
- marketplace.json: drop personal owner email (schema allows name-only)
- Skills frontmatter: author unified to 'yuque' (individual credit
  remains in git history)
- Website hero/meta: state the official distribution-hub positioning

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Promote canonical skills to top-level skills/; the Claude Code plugin
  directory now holds a synced copy (CI-checked, do not edit)
- Remove plugins/openclaw, plugins/opencode, plugins/claude-code:
  SKILL.md is a cross-client format — clients copy skills/ directly,
  so per-client copies and the stub adapter were pure redundancy
- Consolidate every client's install guide into one root AGENT-INSTALL.md
  (Claude Code marketplace flow, OpenCode {env} config, OpenClaw,
  Cursor/VS Code/Windsurf templates, generic agent fallback)
- README (zh/en): four-layer positioning table now points at skills/;
  website modules copy states capability/asset/distribution layers;
  skills links and footer retargeted
- Drop the openclaw npm workspace

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:03 UTC

@chen201724
chen201724 merged commit bc450fd into main Jul 15, 2026
2 checks passed
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