主页 | 郭大发财的记录

已经写过一两个 Skill？这篇文章帮你从"能写"升级到"会写"。

一、Skill 的本质：Context Engineering

Anthropic 团队反复强调一个观点——Skill 本质上是在做 Context Engineering。它不是一个 markdown 文件，而是一个文件夹。用文件夹这个形式，来表达渐进式信息披露的理念。

skill/
├── SKILL.md          # 导航页 + 核心流程 + 关键经验
├── references/       # 详细说明、API 参考、边界条件 → 按需加载
├── scripts/          # 可执行脚本 → 直接执行，零 token
├── examples/         # 示例 → 需要时参照
└── assets/           # 模板、图片、固定素材 → 用于输出

郭大发财大约 10 分钟

Skill-最基础的 Skill 该怎么写

一、Skill 到底是什么

先纠正常见误区：Skill 不是一个文件，而是一个文件夹。

物理上看，它就是一个文件夹，里面放一个 SKILL.md 文件，再加上一些可选的脚本和参考资料。核心就三样东西：

指令（Instructions）：告诉 AI 按什么步骤干活——提供经验和判断
脚本（Scripts）：可执行代码处理确定性任务——提供能力和执行
上下文（Context）：AI 不可能凭空知道的项目背景、团队规范、业务规则

郭大发财大约 8 分钟

不同项目vibe coding时走不同模型通道

场景

VS Code 中安装了 Claude Code for VS Code 插件，配合 cc switch 使用。需求：不同项目vibe coding时走不同模型通道——项目 A 用 DeepSeek，项目 B 用 Claude 原生。

解决方案：项目级 `.claude/settings.local.json`

原理

Claude Code 配置有四级优先级：

.claude/settings.local.json   >   .claude/settings.json   >   ~/.claude/settings.json   >   Managed
      (本地，gitignored)             (项目级，可提交)              (全局，用户级)              (企业策略)

郭大发财大约 1 分钟

CICD-docker自动化部署 Gitea 的踩坑实录

摘要：本文记录了在阿里云 Linux 服务器（Docker 20.10）上自动化部署 Gitea 的完整过程，重点解决 Docker Compose 兼容性、网络超时、PATH 环境变量等实际问题，最终实现"零人工干预"的一键部署脚本。

📋 项目背景

需求场景

目标环境：阿里云 Linux 服务器（公网 IP: 101.201.xxx.xxx）
核心诉求：编写一个自动化 Shell 脚本，实现 Gitea 的"零触摸"安装和配置
技术要求：
- 自动检测并安装 Docker/Docker Compose（如果缺失）
- 支持 SQLite3/PostgreSQL/MySQL 三种数据库选择
- 实时进度反馈（避免脚本卡住时用户不知道发生了什么）
- 兼容老旧 Docker 版本（当前服务器为 Docker 20.10）

郭大发财大约 13 分钟

MCP-最基础的 MCP 该怎么写

一、MCP 是什么？

MCP（Model Context Protocol） 解决的核心问题是——"模型如何访问外部系统和私有知识"。

在 AI 编程的语境下，模型本身不知道你的组件库有哪些 API、不知道设计规范的色值、不知道后端接口的参数定义。MCP 就是把这些团队知识，按**标准化开放规范（OpenSpec）**定义好，通过统一接口暴露给 AI 模型。

一句话：MCP 是团队知识与 AI 模型之间的桥梁。

底层理论基础：OpenSpec — 所有可被机器消费的知识，都应该以标准化的开放规范形式定义。

郭大发财大约 9 分钟

win11-秘诀、窍门、贴士

用 PowerToys 一键启动"语音访问"（重映射菜单键）

痛点

精准的 prompt 提示词需要耗费大量时间敲键盘，手速往往跟不上脑速，而嘴巴的速度能尽量跟得上——所以语音输入是个好选择。Windows 11 自带的**"语音访问"（Voice Access）功能默认启动快捷键为 Win + Ctrl + S，三个键的组合非常不便于盲按，而这个功能又比较常用。刚好笔记本上有一个不怎么用的菜单键**（右 Ctrl 旁边那个），正好可以拿来替代。

AI 模型的无效回答

郭大发财大约 2 分钟

CSS多行文本超出省略末尾最后跟"更多"文案

效果预览

浮动元素是如何定位的？当一个元素浮动之后，它会被移出正常的文档流，然后向左或者向右平移，一直平移直到碰到了所处的容器的边框，或者碰到另外一个浮动的元素。在下面的图片中，有三个红色的正方形。其中有两个向左浮动，一个向右浮动。要注意到第二个向左浮动的正方形被放在第一个向左浮动的正方形的右边。如果还有更多的正方形这样浮动，它们会继续向右堆放，直到填满容器一整行，之后换行至下一行。

郭大发财大约 6 分钟

win11-设置未知文件打开方式

痛点

windows下无关联应用的文件（如host文件、 .conf、.log 、.npmrc、.bashrc或无扩展名文件），每次都需要二次选择用什么应用打开

解决方案

直接使用当前将本批处理文件【以管理员身份运行】即可。

可以交互式选择您的默认应用。

工作原理

通过修改 Windows 注册表实现文件关联： [1] HKEY_CLASSES_ROOT\Unknown\shell\open\command 定义未知类型文件的默认打开命令 [2] HKEY_CLASSES_ROOT\Unknown\shell 设置默认 shell 操作为 "open"（双击触发） [3] HKEY_CLASSES_ROOT\Applications[应用程序] 注册应用程序信息，使其出现在"打开方式"列表中 [4] HKEY_CLASSES_ROOT. 将无扩展名文件关联到 Unknown 文件类型

郭大发财大约 5 分钟

技术文章推荐

AI

理论

MCP、Skill、Function Call 这三个的区别吗？https://mp.weixin.qq.com/s/ADG8VfDw6A9e6JjOoK_e9w
快速理解热门LLM大语言模型 https://mp.weixin.qq.com/s/7v7CFi8R6Eip972NKsB_dA
传统IDE开发到OpenClaw开发历程 https://mp.weixin.qq.com/s/fPgRevMLEt12VH8ekq-PUw
极速开发出一个高质量 Claude Agent Skills 最佳实践 https://mp.weixin.qq.com/s/5hFHlItI3XQUWekejC_kiw
AI Coding 长文分享：如何真正把工具用起来，从原理到实践 https://mp.weixin.qq.com/s/MjBVTfo6Kp2RDG6v46_BPA
从工单、文档到结构化知识库：一套可复用的 Agent 知识采集方案
从 RAG 到 Agentic RAG，再到 Agent Memory：AI 记忆的进化三部曲 https://mp.weixin.qq.com/s/_RV0x_O8FfeLCcaAO0zAqw
Agent Skills与MCP：一场被误解的“替代战争” https://mp.weixin.qq.com/s/nM6S9rHmX_xBcK6jffUMgA
从 Chain 到 Graph：为什么复杂 Agent 需要 LangGraph https://mp.weixin.qq.com/s/OSod2ckG1hH_hoObjIjsUg
Claude 发布 Skills：知识工程让 AI Agent 变成“行家里手” https://mp.weixin.qq.com/s/tjgDVzcZcp6Eni9N8yHbdw
秒懂SKILLS: 模块化的RULES + 轻量化脚本 https://mp.weixin.qq.com/s/i5hkhFe6zpRRpGDrXK6-OA
一文读懂 Skills｜从概念到实操的完整指南 https://mp.weixin.qq.com/s/Bl4ODUxvwO8pYu9nXVmjuQ
极速开发出一个高质量 Claude Agent Skills 最佳实践 https://mp.weixin.qq.com/s/5hFHlItI3XQUWekejC_kiw
Agent全面爆发！一文搞懂Agent开发核心链路 https://mp.weixin.qq.com/s/82kO7w5aq-57-kU_aIqykw
Claude Agent Skills：将 Workflow 打进技能包 https://mp.weixin.qq.com/s/6nhW9EpSYRs3mkHH2c7zNQ
知识库（Knowledge Base）与知识图谱（Knowledge Graph）到底该怎么选？ https://mp.weixin.qq.com/s/qugyc6WlsbrCmG2wTAXzGg
【太学术】智能体Agent与工作流构建实战指南：从选型决策到高效实施 https://mp.weixin.qq.com/s/g93CF_akhd7F-RmpuVoliw
前端开发AI Agent智能体，需要掌握哪些知识？ https://mp.weixin.qq.com/s/76ysq2wereB6r8Ld3buS0w
从对话到自主行动：AI应用如何从 Chat 进化为 Agent？开源项目源码深度揭秘｜得物技术 https://mp.weixin.qq.com/s/2Og361FIQ7WcknBIYFskQw
Browser-Use 源码解析：AI 是怎么"看懂"并操控网页的 https://mp.weixin.qq.com/s/GbDuG02fQNO6MhSFsA4yKg
给 Agent 装上记忆：从聊天历史到知识图谱 https://mp.weixin.qq.com/s/-VCdsyhiRrUS-vrQ8gzKaQ

郭大发财大约 14 分钟

代码格式化-Biome配置与使用

前言请确保已经配置好EditorConfig：https://a.guoqw.com/工程化/代码格式化-EditorConfig配置与使用.html