Skip to content

Commit 49953cd

Browse files
committed
update docs
1 parent fdb433e commit 49953cd

5 files changed

Lines changed: 115 additions & 44 deletions

File tree

docs/.vuepress/sidebar.ts

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,16 @@ export const mySidebar: ThemeSidebarMulti = {
2222
{ text: 'Visual Studio Code', link: 'vscode' },
2323
]
2424
},
25+
{
26+
text: 'AI',
27+
collapsed: false,
28+
prefix: 'ai/',
29+
items: [
30+
{ text: 'Skills', link: 'skills' },
31+
{ text: 'Mcp', link: 'mcp' },
32+
{ text: 'Prompt', link: 'prompt' },
33+
]
34+
},
2535
{
2636
text: '参考',
2737
collapsed: false,

docs/backend/ai/mcp.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
title: MCP
3+
---
4+
5+
[MCP 介绍](../../blog/claude-ai-ecosystem.md){.read-more}
6+
7+
## ace (Augment Context Engine)
8+
9+
官网:[ace](https://www.augmentcode.com/context-engine)
10+
11+
相关文章:[linuxdo#1360514](https://linux.do/t/topic/1360514)
12+
13+
首当其冲的绝对是它,ace 绝对是无与伦比的存在,检索快,定位准;
14+
15+
但其存在国内账号注册难,订阅开通难,费用昂贵,易封号等多重机制,只能说是且用且珍惜
16+
17+
## fetch
18+
19+
源码:[fetch](https://github.com/modelcontextprotocol/servers/tree/main/src/fetch)
20+
21+
MCP 官方实现,使 LLM 能够从网页中检索和处理内容,并将 HTML 转换为 Markdown 以便于阅读和使用,虽然目前很多 LLM 已经内置 web
22+
搜索引擎,但 fetch 仍可作为本级支持的一部分(免费)
23+
24+
## playwright
25+
26+
源码:[playwright-mcp](https://github.com/microsoft/playwright-mcp)
27+
28+
Playwright 是由微软(Microsoft)在 2020 年初开源的现代化 Web 测试与自动化框架,而 playwright-mcp 能够使 LLM
29+
通过结构化的可访问性快照与网页进行交互,从而无需依赖屏幕截图或视觉调整后的模型

docs/backend/ai/prompt.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
title: Prompt
3+
---
4+
5+
提示词不以多取胜,而是可用性,无效的提示词反而会给 LLM 带来负担
6+
7+
[Prompt 介绍](../../blog/claude-ai-ecosystem.md){.read-more}
8+
9+
## 答复
10+
11+
标题:answer
12+
13+
内容:Think and execute in English, but always reply in Chinese(中文)

docs/backend/ai/skills.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
title: Skills
3+
---
4+
5+
开放代理技能生态系统:[skills.sh](https://skills.sh/)
6+
7+
[Skills 介绍](../../blog/claude-ai-ecosystem.md){.read-more}
8+
9+
## fba
10+
11+
源码:[skills](https://github.com/fastapi-practices/skills)
12+
13+
fba 项目开发指南。提供完整的架构规范、编码风格和插件开发指导
14+
15+
安装:
16+
17+
```shell
18+
npx skills add fastapi-practices/skills
19+
```

docs/blog/claude-ai-ecosystem.md

Lines changed: 44 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,24 @@ tags:
88

99
Claude 的“智能体”(agentic)功能越来越强大,随着 **Skills**(技能)的推出,用户开始关注其生态系统中各个组件的角色与协作方式
1010

11+
## Projects(项目)
12+
13+
付费计划专属的自包含工作空间,拥有独立聊天历史、200K 上下文窗口和知识库
14+
15+
### 工作机制
16+
17+
- 可上传文档作为知识库,Claude 在项目内所有对话均可访问
18+
- 接近上限时自动启用 RAG(检索增强生成),有效扩展上下文
19+
- 支持自定义项目指令,适用于所有子对话
20+
21+
### 适用场景
22+
23+
- 需要持久背景知识的项目(如产品发布、研究专题)
24+
- 团队协作(共享知识库)
25+
- 为特定领域设定统一语气、视角或方法
26+
27+
**示例**:创建一个“Q4 产品发布”项目,上传相关文档,设置指令“从产品策略角度分析竞争对手,提出差异化建议”。所有后续对话自动遵循
28+
1129
## Skills(技能)
1230

1331
Skills 是一个“文件夹”,包含指令、脚本和资源文件。Claude 在处理任务时会动态扫描并加载相关 Skills
@@ -27,35 +45,22 @@ Skills 是一个“文件夹”,包含指令、脚本和资源文件。Claude
2745

2846
**示例**:创建一个“品牌指南”Skill,包含颜色、字体、布局规范。此后所有生成内容自动遵守标准,无需重复说明
2947

30-
## Projects(项目)
31-
32-
付费计划专属的自包含工作空间,拥有独立聊天历史、200K 上下文窗口和知识库
33-
34-
### 工作机制
35-
36-
- 可上传文档作为知识库,Claude 在项目内所有对话均可访问
37-
- 接近上限时自动启用 RAG(检索增强生成),有效扩展上下文
38-
- 支持自定义项目指令,适用于所有子对话
39-
40-
### 适用场景
41-
42-
- 需要持久背景知识的项目(如产品发布、研究专题)
43-
- 团队协作(共享知识库)
44-
- 为特定领域设定统一语气、视角或方法
48+
## MCP(Model Context Protocol)
4549

46-
**示例**:创建一个“Q4 产品发布”项目,上传相关文档,设置指令“从产品策略角度分析竞争对手,提出差异化建议”。所有后续对话自动遵循
50+
一种开放标准协议,用于将 Claude 连接到外部工具和数据源(如 Google Drive、GitHub、数据库、CRM)
4751

48-
## Prompts(提示词)
52+
### 作用
4953

50-
对话中直接输入的自然语言指令,短暂且对话式
54+
- 提供持久的外部数据访问,而非每次手动上传
55+
- 类比互联网时代的 HTTP/API,是 AI 时代的“连接器”
5156

52-
### 适用场景
57+
**与 Skills 的关系**
5358

54-
- 一次性任务(如总结文章
55-
- 实时调整(如“语气更专业”
56-
- 临时上下文或格式要求
59+
- MCP 负责连接与数据获取(原子能力
60+
- Skills 负责处理逻辑与流程(SOP 化指导
61+
两者互补:MCP 提供工具,Skills 指导如何使用
5762

58-
**特点**不跨会话持久化。如果同一类指令频繁重复,建议升级为 Skill 或 Project 指令
63+
**适用场景**需要频繁访问外部系统或集成企业工具时
5964

6065
## Subagents(子智能体)
6166

@@ -72,47 +77,42 @@ Skills 是一个“文件夹”,包含指令、脚本和资源文件。Claude
7277
- Subagents 更像“专属员工”,适合特定工作流
7378
- Skills 更像“通用教材”,适合跨对话共享专业知识
7479

75-
## MCP(Model Context Protocol)
76-
77-
一种开放标准协议,用于将 Claude 连接到外部工具和数据源(如 Google Drive、GitHub、数据库、CRM)
78-
79-
### 作用
80+
## Prompts(提示词)
8081

81-
- 提供持久的外部数据访问,而非每次手动上传
82-
- 类比互联网时代的 HTTP/API,是 AI 时代的“连接器”
82+
对话中直接输入的自然语言指令,短暂且对话式
8383

84-
**与 Skills 的关系**
84+
### 适用场景
8585

86-
- MCP 负责连接与数据获取(原子能力
87-
- Skills 负责处理逻辑与流程(SOP 化指导
88-
两者互补:MCP 提供工具,Skills 指导如何使用
86+
- 一次性任务(如总结文章
87+
- 实时调整(如“语气更专业”
88+
- 临时上下文或格式要求
8989

90-
**适用场景**需要频繁访问外部系统或集成企业工具时
90+
**特点**不跨会话持久化。如果同一类指令频繁重复,建议升级为 Skill 或 Project 指令
9191

9292
## 各组件如何协同
9393

94-
真正强大的工作流来自于组合使用:
94+
- **Project** 提供持久上下文和知识库
95+
- **Skills** 注入可复用的专业知识和处理规范
96+
- **MCP** 连接外部实时数据源
97+
- **Subagents** 分担专业子任务
98+
- **Prompts** 用于实时微调
9599

96-
1. **Project** 提供持久上下文和知识库
97-
2. **MCP** 连接外部实时数据源
98-
3. **Skills** 注入可复用的专业知识和处理规范
99-
4. **Subagents** 分担专业子任务
100-
5. **Prompts** 用于实时微调
100+
### 实际案例
101101

102-
**实际案例**构建竞争情报智能体
102+
构建竞争情报智能体
103103

104104
- 创建 **Project**,上传历史报告,设置统一分析指令
105-
- 通过 **MCP** 连接 Google Drive 和 Web 搜索
106105
- 创建 “竞争分析” **Skill**,定义文档检索策略和输出模板
106+
- 通过 **MCP** 连接 Google Drive 和 Web 搜索
107107
- 设置两个 **Subagents**:市场研究员(趋势分析)和技术分析师(产品对比)
108108
- 用户只需一个 **Prompt** 启动:“分析前三大竞争对手的 AI 功能,找出突破机会”
109109

110110
**结果**:Claude 自动协调多源数据、专业方法、子任务分工,输出结构化、高质量报告
111111

112112
## 总结建议
113113

114-
- 重复性专业知识 → 封装为 **Skills**(最高复用性)
115114
- 持久项目上下文 → 用 **Projects**
115+
- 重复性专业知识 → 封装为 **Skills**(最高复用性)
116116
- 外部工具集成 → 用 **MCP**
117117
- 任务隔离与并行 → 用 **Subagents**
118118
- 临时调整 → 用 **Prompts**

0 commit comments

Comments
 (0)