内容
# 符文
> 适用于Claude Code、Cursor、Windsurf、VS Code和JetBrains的91种AI和开发技能。
> 通过MCP或作为原生IDE插件，几秒钟即可安装。
[](LICENSE)
[](https://www.npmjs.com/package/@diottodev/runic)
[](.)
[](.)
[](https://github.com/Diottodev/runic)
---
## 安装
符文支持两种分发渠道：**MCP协议**（推荐 - 适用于所有5种IDE，无需配置）和**原生IDE插件**（VS Code Marketplace / JetBrains Marketplace）。
---
### 通过MCP
MCP（模型上下文协议）是一种被所有主要AI启用IDE支持的标准。一个配置，五个IDE。
#### Claude Code
```bash
claude mcp add --npm @diottodev/runic
```
#### Cursor
将以下内容添加到 `.cursor/mcp.json`（项目）或 `~/.cursor/mcp.json`（全局）：
```json
{
"mcpServers": {
"runic": {
"command": "npx",
"args": ["-y", "@diottodev/runic"]
}
}
}
```
保存后重启Cursor。
#### Windsurf
将以下内容添加到 `~/.codeium/windsurf/mcp_config.json`:
```json
{
"mcpServers": {
"runic": {
"command": "npx",
"args": ["-y", "@diottodev/runic"]
}
}
}
```
或打开Windsurf → 设置 → 级联 → MCP服务器。
#### VS Code
将以下内容添加到 `.vscode/mcp.json`:
```json
{
"servers": {
"runic": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@diottodev/runic"]
}
}
}
```
需要带有Copilot、Continue或其他MCP兼容扩展的VS Code。
#### JetBrains
将以下内容添加到 `~/.config/JetBrains/mcp.json`:
```json
{
"servers": {
"runic": {
"command": "npx",
"args": ["-y", "@diottodev/runic"]
}
}
}
```
或打开设置 → 工具 → AI助手 → MCP服务器。需要JetBrains AI助手2024+。
> **要求：** Node.js ≥ 18 — 运行 `node --version` 验证。
---
### 通过插件
将符文安装为原生IDE扩展 - 不需要JSON配置。
#### VS Code / Cursor
```bash
# VS Code
code --install-extension runic.skills
# Cursor
cursor --install-extension runic.skills
```
或在扩展面板（`Ctrl+Shift+X`）中搜索 **"符文技能"**。
#### JetBrains
打开任何JetBrains IDE（IntelliJ IDEA、WebStorm、PyCharm、GoLand...）→
**设置 → 插件 → 市场** → 搜索 **"符文"** → 安装 → 重启。
---
## 工作原理
### MCP分发
`runic` npm包公开了一个[模型上下文协议](https://modelcontextprotocol.io)服务器。当IDE启动会话时，它通过stdio启动`npx @diottodev/runic`作为子进程。服务器注册所有91种技能作为MCP工具 - IDE的AI可以通过名称调用它们或根据上下文主动触发它们。
**发布/更新到npm：**
```bash
npm run build
npm publish
```
### VS Code / Cursor插件分发
扩展（`packages/vscode-extension/`）包装了MCP服务器，并注册了VS Code命令和上下文菜单项。技能可以通过命令面板（`Ctrl+Shift+P → 符文：...`）访问，并通过`onLanguage` / `onFileSystem`触发器自动激活。
**构建和发布：**
```bash
cd packages/vscode-extension
npm install
npx vsce package # 构建runic-skills-x.x.x.vsix
npx vsce publish # 需要marketplace.visualstudio.com的PAT
```
### JetBrains插件分发
插件（`packages/jetbrains-plugin/`）是一个Kotlin/Gradle项目，使用[IntelliJ平台插件SDK](https://plugins.jetbrains.com/docs/intellij/)。它与JetBrains AI助手扩展点集成，并将符文技能注册为内联操作和工具窗口条目。
**构建和发布：**
```bash
cd packages/jetbrains-plugin
./gradlew buildPlugin # 输出build/distributions/runic-*.zip
./gradlew publishPlugin # 需要plugins.jetbrains.com的PUBLISH_TOKEN环境变量
```
---
## 领域和技能
| 领域 | 技能 | 描述 |
|--------|--------|-------------|
| `engineering/` | 37 | 核心AI和开发工具 - 审查、调试、测试、LLM运维、代理 |
| `engineering-team/` | 38 | 团队技能 - 安全、云、全栈、QA、DevOps |
| `ai-research/` | 2 | 模型评估和基准 |
| `ai-security/` | 1 | 提示注入和强化 |
| `research/` | 8 | 学术和市场研究 |
| `research-ops/` | 5 | 临床、市场、产品和研发运维 |
### 工程亮点
`code-review` · `debug-error` · `explain-code` · `generate-tests` · `git-commit` · `refactor` · `write-docs` · `llm-cost-optimizer` · `prompt-engineering` · `agent-designer` · `rag-architect` · `mcp-server-builder` · `karpathy-coder` · `chaos-engineering` · `ship-gate` · `slo-architect` · `docker-development` · `kubernetes-operator` · `terraform-patterns`
### 安全亮点
`ai-security` · `cloud-security` · `red-team` · `security-pen-testing` · `threat-detection` · `prompt-injection` · `senior-secops` · `incident-response`
---
## 项目结构
```
runic/
├── engineering/ # 37种核心AI和开发技能
├── engineering-team/ # 38种团队角色技能 + 安全
├── ai-research/ # 2种模型评估技能
├── ai-security/ # 1种AI安全技能
├── research/ # 8种研究技能
├── research-ops/ # 5种研究运维技能
│
├── packages/
│ ├── vscode-extension/ # VS Code / Cursor原生插件
│ └── jetbrains-plugin/ # JetBrains IDE原生插件
│
├── web/ # landing page (React + Vite + Tailwind)
│
├── CLAUDE.md # 导航和路线图
├── SKILL-AUTHORING-STANDARD.md # 10-模式框架
├── CONVENTIONS.md
├── CONTRIBUTING.md
└── CHANGELOG.md
```
---
## 贡献
参见 [CONTRIBUTING.md](./CONTRIBUTING.md)。仅限AI和开发技能。PR目标为`dev`。
## 许可证
MIT — [Diottodev](https://github.com/Diottodev/runic)
