# tools-skills

**Repository Path**: jwssw/skills

## Basic Information

- **Project Name**: tools-skills
- **Description**: 软件开发技能仓库，涵盖claude.md文档生成、前后端开发流水skill技能。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-07
- **Last Updated**: 2026-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Tools Skills

基于 Claude Code 的技能集合：语言无关的 SDD 内核、后端/前端领域一键流、项目文档初始化与技能分发。详细规则在各技能的 `SKILL.md` 与 `references/`，本文件只做索引与安装说明。

## 环境依赖

### 必需插件

| 插件 | 安装命令 | 用途 | 适用技能 |
|------|----------|------|----------|
| **code-review** | `/plugin install code-review` | 多代理并行代码审查，支持 `--score` / `--strict` | 全部 |
| **code-simplifier** | `/plugin install code-simplifier` | 保持功能不变的前提下简化代码 | 全部 |
| **commit-commands** | `/plugin install commit-commands` | Git 提交流水线 | 全部 |
| **claude-md-management** | `/plugin install claude-md-management` | CLAUDE.md 更新与优化 | 全部 |
| **hookify** | `/plugin install hookify` | 从会话中提取反模式并生成预防性 hooks | backend-dev / vue-dev / vue2-dev / vue3-dev |
| **jdtls-lsp** | `/plugin install jdtls-lsp` | Java LSP 诊断与依赖检查 | backend-dev |

### 主要命令

| 插件 | 命令 | 说明 |
|------|------|------|
| code-review | `/review <path> [--score] [--strict]` | 代码审查 |
| code-simplifier | `/simplify <path>` | 代码简化 |
| commit-commands | `/commit` `/commit-push` `/clean-gone` | 规范化提交 |
| claude-md-management | `/revise-claude-md` `/claude-md-improver` | 文档维护 |
| hookify | `/hookify` | 创建预防性 hooks |
| jdtls-lsp | LSP 自动生效 | Java 代码诊断 |

## 安装

本仓库包含 8 个技能目录：6 个功能技能（`sdd-dev`、`backend-dev`、`vue-dev`、`init-project-doc`、`diagram-design`、`skill-dispatcher`）与 2 个 Vue 薄别名（`vue2-dev`、`vue3-dev`）。

```bash
# 方式一：首次克隆到 Claude Code 技能目录
cd ~/.claude
git clone https://gitee.com/jwssw/skills.git skills

# 方式二：已有目录中拉取最新
cd ~/.claude/skills
git pull origin master
```

安装后可用入口：

```
/sdd-dev  /backend-dev  /vue-dev  /vue2-dev  /vue3-dev  /init-project-doc  /diagram-design  /skill-dispatcher
```

结构校验：

```bash
node scripts/verify-skills.mjs
```

## 技能索引

| 技能 | 定位 | 入口 | 详细文档 |
|------|------|------|----------|
| `sdd-dev` | 语言无关的规范驱动开发内核，产出 spec / plan / tasks 三份长期工件 | `/sdd-dev` | [SKILL.md](sdd-dev/SKILL.md) |
| `backend-dev` | `sdd-dev` 的薄包装 + 后端预设，注入九条章程、Java 验证与审查维度 | `/backend-dev` | [SKILL.md](backend-dev/SKILL.md) |
| `vue-dev` | Vue 2 / Vue 3 共用前端内核，自动识别版本 | `/vue-dev` | [SKILL.md](vue-dev/SKILL.md) |
| `vue2-dev` | 薄别名，转发到 `vue-dev --vue2` | `/vue2-dev` | [SKILL.md](vue2-dev/SKILL.md) |
| `vue3-dev` | 薄别名，转发到 `vue-dev --vue3` | `/vue3-dev` | [SKILL.md](vue3-dev/SKILL.md) |
| `init-project-doc` | 生成根级 / 工程级 / 模块级三层 `CLAUDE.md` | `/init-project-doc` | [SKILL.md](init-project-doc/SKILL.md) |
| `diagram-design` | 上游第三方技能（[cathrynlavery/diagram-design](https://github.com/cathrynlavery/diagram-design)），输出自包含 HTML + 内联 SVG 的编辑风图表 | `/diagram-design` | [SKILL.md](diagram-design/SKILL.md) |
| `skill-dispatcher` | 把技能同步到 Claude Code / Trae-CN / Cursor | `/skill-dispatcher` | [SKILL.md](skill-dispatcher/SKILL.md) |

## 依赖关系

```
sdd-dev            ──> 无外部依赖

backend-dev        ──> sdd-dev（内核 + 后端 preset）
                       hookify / code-review / claude-md-management / jdtls-lsp / code-simplifier

vue-dev            ──> frontend-design（内置）
                       hookify / code-review / code-simplifier

vue2-dev / vue3-dev ──> vue-dev（薄别名，只做转发）

init-project-doc   ──> claude-md-management

diagram-design     ──> 无外部依赖（上游技能，可选使用其 scripts/ 下的 Python 校验工具）

skill-dispatcher   ──> 无外部依赖
```

## 核心流程速查

| 场景 | 技能 | 流程 |
|------|------|------|
| 任意技术栈，规范优先、需可追溯 | `sdd-dev` | `constitution → specify → 人工门禁 → plan → 人工门禁 → tasks → analyze → implement ⇄ converge` |
| 后端新增功能 / 接口 | `backend-dev` | 安装后端 preset → `/sdd-dev --preset backend` → JDTLS + 编译门禁 → code-review → hookify → revise-claude-md |
| 后端 bug 修复 | `backend-dev` | `/sdd-dev bug` → JDTLS + 编译门禁 → 按后端维度复核 |
| Vue 页面 / 组件 | `vue-dev` | `frontend-design → hookify → code-review → simplify` |
| Vue2 / Vue3 指定入口 | `vue2-dev` / `vue3-dev` | 转发到 `vue-dev --vue2` / `--vue3` |
| 项目文档初始化 | `init-project-doc` | 需求分析 → 方案确认 → 生成三层 CLAUDE.md → 行数检查 |
| 架构图 / 流程图 / 时序图等 | `diagram-design` | 选图型 → 读对应 `references/type-*.md` → 生成自包含 HTML/SVG |
| 技能同步 | `skill-dispatcher` | 扫描源技能 → 备份 → 原子替换 → 差异校验 |

### 工件路径

`sdd-dev` 的工件位于仓库根：`.specify/memory/constitution.md`、`.specify/presets/<name>/`、`.specify/bugs/<slug>/`、`specs/NNN-<kebab-case-name>/`。

`vue-dev` 从根目录或 `frontend/package.json` 读取 Vue 版本；也可用 `--vue2` / `--vue3` 强制覆盖。

## 常用示例

```
# 规范驱动开发
/sdd-dev 为订单模块增加导出能力，先产出规范再实现

# 后端开发
/backend-dev 开发订单导出接口，导出 CSV，支持按状态与日期筛选

# Vue 开发（自动识别版本）
/vue-dev 开发用户管理列表页，包含搜索区、表格、分页与新增/编辑弹窗

# 指定 Vue2 / Vue3
/vue2-dev 开发用户管理列表页，使用 Element UI + Options API
/vue3-dev 开发用户管理列表页，使用 Element Plus + Composition API + TypeScript

# 项目文档
/init-project-doc
```

## 开发与校验

```bash
node scripts/verify-skills.mjs      # frontmatter、description、行数上限、references 链接
```

改动技能后：

1. 更新对应 `SKILL.md` 与 `references/`
2. 跑 `node scripts/verify-skills.mjs`，全绿再继续
3. 需要生效时执行 `/skill-dispatcher`；分发前可加 `--dry-run` 预览

## 参考文档与历史记录

以下内容保留作参考，可能与当前流程不一致；冲突时以各技能 `SKILL.md` 为准。

- [docs/questioning-convention.md](docs/questioning-convention.md) — 收尾提问纪律（一次一问、附建议）
- [docs/references/andrej-karpathy-claude.md](docs/references/andrej-karpathy-claude.md) — LLM 编码行为准则原文
- [docs/example-conversation.md](docs/example-conversation.md) — 后端端到端对话实录
- [docs/每日开发终极流水线（前后端规范统一·可长期运维版）.md](docs/每日开发终极流水线（前后端规范统一·可长期运维版）.md) — 旧版每日流水线
- [docs/技能分发需求.md](docs/技能分发需求.md) — 分发说明指针
- [docs/superpowers/](docs/superpowers/) — 历史设计与实施计划
- [specs/001-skill-optimization/decisions.md](specs/001-skill-optimization/decisions.md) — 本次体系优化的决策记录