Learning in Progress · 2026

AI 智能体
学习与实践笔记

记录使用 AI 智能体(Qwen Code)的日常经验——从基础对话到编写 Skills、接入 MCP 服务,再到真实项目中的应用场景与踩坑心得。

4
核心模块
10+
自定义 Skills
6
MCP 服务
持续学习中
01

什么是 AI 智能体?

不只是聊天机器人——AI 智能体是能调用工具、读写文件、执行命令、与外部系统交互的自主代理。

🤖

对话 → 行动

传统 AI 只能回答问题。智能体可以直接执行任务:写代码、创建文件、搜索网络、操作数据库,甚至控制浏览器。

🔧

工具调用

智能体通过 Tool Use 协议调用各种工具——文件读写、Shell 命令、API 请求,让 AI 从"说"变成"做"。

🧩

可扩展能力

通过 Skills(自定义技能)和 MCP(模型上下文协议),可以无限扩展智能体的能力边界,让它成为真正的个人助手。

🧠

上下文记忆

智能体可以记住项目结构、编码规范、用户偏好,甚至跨会话保存知识,越用越懂你。

agent-workflow.md
## AI 智能体工作流 用户: "帮我做一个网页" ↓ 智能体: 理解需求 → 规划结构 ↓ 工具调用: read_file, write_file, edit ↓ 技能加载: frontend-design skill ↓ 外部服务: MCP → WebSearch (查资料) ↓ 部署: git add → commit → push → GitHub Pages ↓ 用户: 收到在线链接 ✅
02

Qwen Code 使用经验

Qwen Code 是阿里通义千问推出的 CLI 智能体,在终端中直接与代码和项目交互。以下是日常使用中的核心场景和技巧。

日常开发

代码编写与重构

直接描述需求,智能体自动分析项目结构、遵循现有代码风格进行编写。

  • 自动识别框架和依赖
  • 遵循项目命名规范和代码风格
  • 一次性修改多个关联文件
  • 自动生成测试代码
项目管理

文件与 Git 操作

从创建文件到提交代码,智能体可以完成完整的项目管理流程。

  • 批量创建/重命名/移动文件
  • 自动 git add、commit、push
  • 处理合并冲突
  • 跨目录批量替换内容
文档处理

多格式文档生成

通过 Skills 扩展,可以生成 Word、PPT、PDF、Excel 等专业文档。

  • 学术专著排版与引用管理
  • PPT 演示文稿自动生成
  • 会议纪要从语音转写生成
  • 数据清洗与 Excel 报表
效率技巧

高效使用方法

掌握这些技巧可以大幅提升与智能体协作的效率。

  • 用 QWEN.md 定义项目规范
  • 复杂任务先让它出方案再执行
  • 善用 /review 做代码审查
  • 并行任务用 agent 分发给子代理
QWEN.md — 项目规范示例
# 项目规范 ## 代码风格 - 使用 ESLint + Prettier 统一格式 - 组件使用 PascalCase,工具函数使用 camelCase - 中文注释,英文变量名 ## 部署流程 - 本地开发 → git push → GitHub Pages 自动部署 - 个人网站仓库: Jerrychen94/my-pages ## 常用路径 - 个人网站: D:\nut\进行项目\个人项目\my-pages - 实习项目: D:\nut\进行项目\研究院-实习生
03

Skills · 自定义技能

Skills 是 Qwen Code 的扩展机制——用 Markdown 编写技能描述,让智能体在特定场景下自动加载专业能力。边做边写,逐步积累。

skill-structure.md — Skill 文件结构
## 一个 Skill 由以下部分组成: skill.md # 技能描述与触发规则(必须) reference.md # 详细参考文档(可选) scripts/ # 辅助脚本(可选) evals/ # 测试用例(可选) ## 触发方式 自动触发: 根据 description 中的关键词匹配 手动触发: 用户输入 /skill-name ## 存放位置 ~/.qwen/skills/your-skill/ # 用户级(跨项目) .qwen/skills/your-skill/ # 项目级(仅当前项目)
deploy-site
部署工具
使用中

一键发布到 GitHub Pages

将本地 HTML 文件发布到个人网站。自动处理文件复制、路径替换、git 提交推送。解决了网络认证、路径映射等常见问题。

git github-pages deployment
ticktick-cli
任务管理
使用中

滴答清单 CLI 集成

通过 dida CLI 管理滴答清单的任务、项目、习惯和专注记录。支持创建任务、查询日程、打卡习惯等操作,让 AI 直接帮你管理待办。

dida-cli task-management productivity
frontend-design
设计生成
使用中

高质量前端界面生成

生成有设计感的网页、组件和 UI。内置设计原则和审美标准,避免"AI 味"的通用风格,产出更接近专业设计师水准的作品。

html css design-system responsive
docx / pptx / pdf
文档处理
使用中

专业文档生成套件

Word 文档(含目录、页眉页脚)、PPT 演示文稿、PDF 处理(合并/拆分/OCR)。覆盖从学术报告到商务文档的全场景需求。

docx pptx pdf formatting
academic-book
学术写作
使用中

学术专著写作助手

规范化学术书籍的章节结构、引用格式、参考文献管理。支持 Pandoc 导出、上标引用、图表交叉引用、数据来源标注等学术写作规范。

academic citation pandoc docx-export
transcript-to-meeting
会议处理
使用中

语音转写 → 会议纪要

将语音转写文件(docx 或 txt)自动转换为结构化会议记录。提取关键议题、决议事项、待办任务,省去手动整理的时间。

transcription meeting-notes summarization
04

MCP · 外部服务接入

Model Context Protocol(MCP)让智能体可以调用外部 API 和服务——地图搜索、网络检索、语音识别、网页解析,打通 AI 与真实世界的连接。

settings.json — MCP 配置示例
{ "mcpServers": { "amap-maps": { "command": "npx", "args": ["-y", "@amap/amap-maps-mcp-server"] }, "WebSearch": { "command": "npx", "args": ["-y", "@bailian/web-search-mcp"] } } }
🗺️

高德地图

amap-maps

地理编码、路径规划、POI 搜索、天气查询、距离测量。支持驾车/步行/骑行/公交多种出行方式。

🔧 18 tools
🔍

网络搜索

WebSearch (百炼)

实时搜索百科知识、时事新闻、天气等信息。让智能体获取最新的互联网信息,而非依赖训练数据。

🔧 1 tool
🎙️

语音转写

SpeechToText (百炼)

将录音文件转换为文本,支持多声道识别和批量处理。会议录音、访谈记录一键转文字。

🔧 2 tools
🌐

网页解析

WebParser (百炼)

抓取网页内容并格式化为 Markdown,支持提取子链接。用于深度阅读和资料收集。

🔧 2 tools
🧠

Sequential Thinking

Sequential_Thinking

动态反思式问题求解工具,帮助智能体进行多步骤推理和深度思考,提升复杂问题的解决质量。

🔧 1 tool
🔎

Bocha 搜索

market-cmapi

备用网络搜索服务,提供更广泛的搜索结果覆盖,与百炼搜索互补使用。

🔧 1 tool
05

应用场景 · 实战案例

真实项目中的 AI 智能体应用——不是 Demo,是实际完成的工作。

01

实习项目网站全流程

为研究院实习项目创建完整网站:从需求分析 → 设计页面 → 编写代码 → 部署上线,全程由 AI 智能体完成。包含中英文切换、滚动动画、响应式布局,最终部署到 GitHub Pages。

frontend-design deploy-site HTML/CSS/JS
02

会议录音 → 结构化纪要

实习生汇报会议的完整处理流程:录音文件 → MCP 语音转写 → transcript-to-meeting 技能处理 → 生成结构化会议纪要(含议题、决议、待办)→ 导出 Word 文档。

SpeechToText MCP transcript-to-meeting docx
03

个人网站内容管理

维护个人 GitHub Pages 网站,包括新增页面、更新导航、批量部署。通过 deploy-site 技能实现一键发布,自动处理路径映射和 git 操作。

deploy-site git HTML
04

研究资料收集与分析

利用 MCP 服务进行资料收集:WebSearch 搜索最新数据 → WebParser 深度抓取网页内容 → 整理分析 → 生成研究报告。支持多语言资料的检索和整合。

WebSearch MCP WebParser MCP Sequential Thinking
05

任务管理与日程规划

通过滴答清单集成,直接用自然语言管理任务:"帮我创建下周的汇报准备任务"、"查看今天的高优先级任务"、"把这个任务移到项目追踪清单"。

ticktick-cli dida CLI
06

学术文档排版与导出

使用 academic-book 技能处理学术写作:规范化章节结构、管理参考文献引用、标注数据来源、处理图表交叉引用,最终通过 Pandoc 导出为符合学术规范的 Word 文档。

academic-book docx pandoc
06

心得与体会

使用 AI 智能体这段时间的一些思考和经验总结。

💡 关键认知

🎯

提示词即接口

与智能体沟通就像设计 API——越清晰的输入,越稳定的输出。学会把模糊需求拆解为具体指令是核心技能。

🔄

迭代优于完美

不要期望一次对话就得到完美结果。先让 AI 出初版,然后逐步反馈调整,效率远高于反复修改提示词。

🧩

Skills 是复利

每写一个 Skill,后续所有类似任务都受益。投入时间编写和维护 Skills,长期回报巨大。

🌐

MCP 打破边界

接入外部服务后,AI 不再是封闭系统。地图、搜索、数据库、API——一切都可以成为智能体的"手和眼"。

📋

QWEN.md 很重要

项目规范文件让智能体理解你的代码风格、部署流程、常用路径。花 10 分钟写清楚,省下无数次解释。

人机协作 > 全自动

最好的模式不是完全交给 AI,而是人做决策和审核,AI 做执行和加速。保持对输出的判断力。