You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: 回答关于 Deep Code CLI 本身的问题——包括功能特性、配置项、斜杠命令、Skills、MCP 集成、权限、通知、会话持久化及故障排查。当用户询问如何配置或使用 Deep Code、如何设置 MCP 服务器、配置通知（如 Slack/飞书）、管理权限、查看可用技能、理解斜杠命令、配置思考模式、使用 Undo 功能，或咨询 Deep Code 与 VSCode 集成等场景时使用。
4
+
---
5
+
6
+
# Deep Code Self-Refer
7
+
8
+
This Skill helps you answer user questions about Deep Code CLI itself by consulting the reference documentation bundled with this Skill. All docs live in the `references/` subdirectory — always refer to them for authoritative answers.
9
+
10
+
## When to use this Skill
11
+
12
+
Use this Skill when the user asks any question about Deep Code itself, such as:
13
+
14
+
- "列出可用的 skills"
15
+
- "如何配置 MCP？"
16
+
- "给当前项目配置 playwright mcp"
17
+
- "怎么启用搜索功能？"
18
+
- "支持哪些模型？"
19
+
- "如何配置思考模式？"
20
+
- "怎么设置权限？"
21
+
- "任务完成后怎么发通知？"
22
+
- "支持哪些斜杠命令？"
23
+
- "会话历史保存在哪里？"
24
+
- "/undo 是怎么工作的？"
25
+
- "Deep Code 和 VSCode 插件怎么配合？"
26
+
- Any other question about Deep Code CLI's features, configuration, or usage.
27
+
28
+
## Instructions
29
+
30
+
### Step 1: Identify the topic
31
+
32
+
Map the user's question to the appropriate document(s):
Use the `Read` tool to read the appropriate document(s) from the list above. All paths are relative to this Skill's loaded root directory, where the `references/` subdirectory lives.
46
+
47
+
- If the question spans multiple topics, read multiple documents.
48
+
- If a document doesn't exist in the user's preferred language (e.g., Chinese), try the other language variant (e.g., `references/configuration_en.md`).
49
+
- When answering from references/README.md, focus on the relevant sections.
50
+
51
+
### Step 3: Answer with precision
52
+
53
+
-**Quote the doc directly** for config examples, JSON snippets, or command syntax.
54
+
-**Don't guess** — if the answer isn't in the docs, say so and suggest checking GitHub Issues.
55
+
-**Provide copy-paste-ready configurations** when the user asks to set something up (e.g., MCP servers, notify scripts, permissions).
56
+
-**Mention related docs** when appropriate (e.g., MCP setup references `references/mcp.md`, the permissions section references `references/permission.md`).
57
+
58
+
### Step 4: Handle common request patterns
59
+
60
+
**"列出/查看可用的 skills":**
61
+
- Explain the skill scanning paths from references/README.md (`./.deepcode/skills/`, `./.agents/skills/`, `~/.deepcode/skills/`, `~/.agents/skills/`, and bundled built-in skills)
62
+
- Explain that `/skills` slash command lists available skills
63
+
- Mention `enabledSkills` in `settings.json` for enabling/disabling specific skills
64
+
65
+
**"配置 <X> MCP":**
66
+
- Read `references/mcp.md` for the MCP format and examples
67
+
- Ask the user for any required credentials (e.g., GitHub token)
68
+
- Provide the exact `mcpServers` JSON block to add to `settings.json`
69
+
- Mention using `/mcp` to verify the setup afterwards
70
+
71
+
**"如何配置/修改 <设置项>":**
72
+
- Read `references/configuration.md`
73
+
- Explain which `settings.json` field controls the setting
74
+
- Clarify user-level (`~/.deepcode/settings.json`) vs project-level (`.deepcode/settings.json`)
75
+
- Provide the exact JSON snippet
76
+
77
+
**"<斜杠命令> 是做什么的？":**
78
+
- Read the slash command table from references/README.md
79
+
- Provide a brief explanation with any additional context from relevant docs
80
+
81
+
### Best practices
82
+
83
+
1.**Always consult the docs first** — never answer from memory alone; the docs are the source of truth.
84
+
2.**Provide copy-paste-ready JSON** — users want to copy config blocks directly into their `settings.json`.
85
+
3.**Be specific about file paths** — always specify whether it's `~/.deepcode/settings.json` or `.deepcode/settings.json`.
86
+
4.**Mention `/mcp` verification** — after any MCP configuration change, remind users to use `/mcp` to verify.
87
+
5.**Acknowledge both Chinese and English docs** — the project has docs in both languages (`references/xxx.md` for Chinese, `references/xxx_en.md` for English).
88
+
89
+
## Examples
90
+
91
+
### Example 1: "列出可用的skills"
92
+
93
+
Read references/README.md, locate the Skills section. Answer:
94
+
95
+
- Skills are discovered from: `./.deepcode/skills/`, `./.agents/skills/`, `~/.deepcode/skills/`, `~/.agents/skills/`, and bundled built-in skills such as `bundled:deepcode-self-refer/SKILL.md`.
96
+
- Use `/skills` slash command in the Deep Code CLI to list all available skills
97
+
- Use `enabledSkills` in `settings.json` to enable/disable skills by name
98
+
99
+
### Example 2: "给当前项目配置playwright mcp"
100
+
101
+
Read `references/mcp.md`, locate the Playwright example. Answer:
102
+
103
+
- Add to `settings.json` (user-level `~/.deepcode/settings.json` or project-level `.deepcode/settings.json`):
104
+
105
+
```json
106
+
{
107
+
"mcpServers": {
108
+
"playwright": {
109
+
"command": "npx",
110
+
"args": ["@playwright/mcp@latest"]
111
+
}
112
+
}
113
+
}
114
+
```
115
+
116
+
- If merging with existing config, add the `"playwright"` entry into the existing `mcpServers` object
117
+
- After saving, use `/mcp` in Deep Code to verify the server is running
118
+
119
+
### Example 3: "怎么设置通知到Slack?"
120
+
121
+
Read `references/notify.md`, locate the Slack section. Answer with the script + config.
122
+
123
+
### Example 4: "如何只允许AI读写当前目录?"
124
+
125
+
Read `references/permission.md`, locate the strict mode example. Provide the exact JSON.
0 commit comments