Skip to content

CLAUDE.md

Latest commit

 

History

History
71 lines (45 loc) · 3.87 KB

CLAUDE.md

File metadata and controls

71 lines (45 loc) · 3.87 KB
Raw

xkcoding-skills — Claude Code Skills 仓库

项目概览

个人 Claude Code Skills marketplace 仓库。每个 Skill 是一个目录，包含 SKILL.md（Agent 指令）+ references/（知识文档）+ scripts/（工具脚本）。

当前 Skills

desktop-kit（MVP）

将任意 Web App（React/Vue/静态页面）打包为 macOS 桌面客户端。

核心设计文档：desktop-kit/DESIGN.md — 包含完整的设计思路、知识来源、架构决策和实现规划。该文档沉淀了从 Argus 项目中提炼的全部工程经验，实现前务必先读此文档。

agent-team-setup（Stable）

一条命令完成 Claude Code Agent Teams 环境准备：开启实验特性、配置显示模式、安装依赖、验证环境。

结构：

  • agent-team-setup/SKILL.md — Agent 指令入口，含 AskUserQuestion 引导和子命令路由
  • agent-team-setup/scripts/doctor.sh — 环境诊断脚本（检测 Claude Code、tmux、iTerm2、settings.json）
  • agent-team-setup/references/agent-teams-guide.md — Agent Teams 使用指南和最佳实践

session-insights（Stable）

分析 Claude Code 会话数据，生成带 Mermaid 图表的 Markdown 洞察报告。支持四种模式：概览、逐个详细、并行详细（claude -p 真并行）、后台详细。

结构：

  • session-insights/SKILL.md — Agent 指令入口，含 AskUserQuestion 路由和分流逻辑
  • session-insights/scripts/session-insights.py — 数据提取（纯 Python 标准库）
  • session-insights/scripts/session-insights-analyze.py — 并行分析编排（ThreadPoolExecutor + claude -p）
  • session-insights/references/parallel-prompt.md — 并行模式执行指令

skill-audit（New）

审查 Agent Skill/Prompt 质量，检测事实与推断混淆、行为锚定、过度详细、排他性分类等反模式。

结构：

  • skill-audit/SKILL.md — 审计框架，含五项检查、审计流程和报告模板

dark-luxury-editorial（New）

把旅行文本/路书/游记转成暗黑奢华杂志风（Kinfolk-inspired）的 React + Tailwind 编辑型网页。覆盖从 intent → 行程规划 → 内容改写 → 视觉实现 → 图片/BGM 素材 → QA 全流程。

结构：

  • dark-luxury-editorial/SKILL.md — 入口路由，按任务形态（intent / 已有文本 / 视觉回归 / 素材 / 文案 / 实现 patterns / 产品演进）分流加载 references
  • dark-luxury-editorial/references/ — 8 个分主题文档：benchmark 视觉基线、brief→site 工作流、intent→行程规划、图片与音频管线、实现 recipes、editorial 文案、failure modes/QA、产品演进

md-image-rehost（Stable）

抽取 Markdown 里的图片，sharp 压缩后转存到自有阿里云 OSS/CDN（ali-oss），就地替换链接。远程外链 + 本地图默认都传；GIF 取首帧（适配 OSS 原图保护样式）；对象键镜像源文件位置。唯一依赖 Node.js 的 skill，首次需 npm install（node_modules/ 已 gitignore）。

结构：

  • md-image-rehost/SKILL.md — Agent 指令，含 OSS 环境变量约定、key 方案、GIF/样式注意事项
  • md-image-rehost/scripts/rehost.mjs — 自包含 CLI（抽取→压缩→ali-oss 上传→改写），自动加载 ~/.config/md-image-rehost.env
  • md-image-rehost/package.json — sharp + ali-oss 依赖

开发规范

  • Skill 入口文件必须是 SKILL.md，含 YAML frontmatter（name + description）
  • 知识文档放 references/，可执行脚本放 scripts/，评测用例放 evals/evals.json（可选）
  • marketplace 注册在 .claude-plugin/marketplace.json
  • 中文注释和文档，代码标识符保持英文

OpenSpec 使用

本仓库使用 OpenSpec 管理变更。实现 desktop-kit 时：

  1. 先读 desktop-kit/DESIGN.md 了解完整上下文
  2. 用 /opsx:new desktop-kit-mvp 创建变更
  3. 按 DESIGN.md 第 10 节的优先级逐步实现