代码质量 on AI 观察

把「正则解释与修复」写成 MCP 服务：工具定义与客户端配置

Sun, 18 Oct 2026 08:46:17 +0800

把「正则解释与修复」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（正则表达式与样例文本），按什么顺序处理，交付什么（解释、修正版与测试用例），哪些事不能做。Skill 就是把这些写下来的载体。

本文介绍如何在 MCP 服务 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

在团队推广「空值安全检查」Skill：版本、评审与维护

Sun, 18 Oct 2026 08:45:00 +0800

「空值安全检查」是开发者的高频任务。它的输入通常是源码文件，期望得到的是风险位置与修复示例。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。

一个人用得顺手的技能，推广到团队时会遇到新问题：放在哪、谁来改、怎么知道它变好了还是变坏了。下面以「空值安全检查」为例给出落地做法。

按团队需求定制「遗留代码考古」Skill：可调参数与改写示例

Sun, 18 Oct 2026 08:44:31 +0800

「遗留代码考古」是开发者的高频任务。它的输入通常是代码片段与 git 历史，期望得到的是成因说明与修改建议。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。

通用版的「遗留代码考古」能覆盖大多数情况，但每个团队都有自己的习惯。下面列出最值得调整的几个地方。

按团队需求定制「空值安全检查」Skill：可调参数与改写示例

Sun, 18 Oct 2026 08:44:06 +0800

开发者经常要做「空值安全检查」这类事：找出可能的空指针或未定义访问并给出防护写法。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。

通用版的「空值安全检查」能覆盖大多数情况，但每个团队都有自己的习惯。下面列出最值得调整的几个地方。

复杂度热点分析 Skill 避坑指南：写法、权限与输出问题

Sun, 18 Oct 2026 08:43:45 +0800

把「复杂度热点分析」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（仓库与 git 历史），按什么顺序处理，交付什么（热点文件排行与治理建议），哪些事不能做。Skill 就是把这些写下来的载体。

下面是把「复杂度热点分析」做成技能时最常见的 8 个问题，每条都给出改法。

代码讲解 Skill 上传到 Claude 应用的完整流程

Sun, 18 Oct 2026 08:43:41 +0800

「代码讲解」是开发者的高频任务。它的输入通常是模块路径，期望得到的是分层讲解文档。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。

本文介绍如何在 Claude 应用中的 Skills 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

性能剖析 Skill 测试清单：正常、边界与越界输入

Sun, 18 Oct 2026 08:43:22 +0800

如果你在代码仓库与终端里反复做性能剖析，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。

技能写好后，最常见的问题是“演示时很好，真用时出错”。原因通常是只用一份理想样例试过。本文给「性能剖析」准备 6 类测试输入。

用 Function Calling 实现「魔法数字清理」：函数定义与调用流程

Sun, 18 Oct 2026 08:43:09 +0800

开发者经常要做「魔法数字清理」这类事：把散落的硬编码常量提取为具名常量或配置。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。

本文介绍如何在 Function Calling 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

日志规范化 Skill 的 SKILL.md 模板与写作要点

Sun, 18 Oct 2026 08:42:37 +0800

「日志规范化」是开发者的高频任务。它的输入通常是服务代码，期望得到的是改造后的日志调用与规范说明。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。

本文以「日志规范化」为例，逐段讲解 SKILL.md 的写法。SKILL.md 是 Claude Agent Skills 采用的格式：YAML 头 + Markdown 正文，其结构思路也适用于其他平台的规则文件与指令。

用 n8n AI Agent 实现「代码风格迁移」：流程搭建与工具配置

Sun, 18 Oct 2026 08:41:48 +0800

如果你在代码仓库与终端里反复做代码风格迁移，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。

本文介绍如何在 n8n AI Agent 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

「代码归属梳理」智能体 Skill 是什么：能做什么、适合谁、怎么开始

Sun, 18 Oct 2026 08:39:46 +0800

如果你在代码仓库与终端里反复做代码归属梳理，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。

一句话说明

「代码归属梳理」技能让智能体根据提交历史生成目录负责人建议，辅助评审分配。你提供git 历史，它按固定步骤处理，交付目录与负责人对照表。

Gemini CLI 自定义命令实现「功能开关清理」：TOML 写法与用法

Sun, 18 Oct 2026 08:38:36 +0800

「功能开关清理」是开发者的高频任务。它的输入通常是开关列表与代码，期望得到的是清理后的代码与清单。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。

本文介绍如何在 Gemini CLI 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

「无用代码排查」Skill 组合用法：和相关技能串成流水线

Sun, 18 Oct 2026 08:38:29 +0800

把「无用代码排查」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（代码仓库），按什么顺序处理，交付什么（疑似无用代码清单与依据），哪些事不能做。Skill 就是把这些写下来的载体。

单个技能解决一个环节，把几个技能串起来，才能覆盖一整段工作。本文示范「无用代码排查」与三个相关技能的组合。

GPTs 实战：做一个专门代码风格迁移的定制助手

Sun, 18 Oct 2026 08:38:10 +0800

把「代码风格迁移」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（代码与新风格配置），按什么顺序处理，交付什么（格式化后的代码），哪些事不能做。Skill 就是把这些写下来的载体。

本文介绍如何在 GPTs 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

用 Cursor Rules 实现「循环依赖拆解」：.mdc 规则写法与示例

Sun, 18 Oct 2026 08:37:52 +0800

如果你在代码仓库与终端里反复做循环依赖拆解，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。

本文介绍如何在 Cursor Rules 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

用 GPTs 实现「错误处理审查」：指令、知识与 Actions

Sun, 18 Oct 2026 08:37:25 +0800

「错误处理审查」是开发者的高频任务。它的输入通常是代码仓库，期望得到的是问题位置与修复建议。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。

本文介绍如何在 GPTs 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

循环依赖拆解 Skill 团队落地指南：从个人用到全员共享

Sun, 18 Oct 2026 08:35:26 +0800

一个人用得顺手的技能，推广到团队时会遇到新问题：放在哪、谁来改、怎么知道它变好了还是变坏了。下面以「循环依赖拆解」为例给出落地做法。

给「正则解释与修复」Skill 写测试用例：6 类输入与预期行为

Sun, 18 Oct 2026 08:34:58 +0800

「正则解释与修复」是开发者的高频任务。它的输入通常是正则表达式与样例文本，期望得到的是解释、修正版与测试用例。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。

技能写好后，最常见的问题是“演示时很好，真用时出错”。原因通常是只用一份理想样例试过。本文给「正则解释与修复」准备 6 类测试输入。

在 AGENTS.md 里写「重构方案规划」技能：通用编码智能体都能用

Sun, 18 Oct 2026 08:34:03 +0800

如果你在代码仓库与终端里反复做重构方案规划，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。

本文介绍如何在 AGENTS.md 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

n8n 实战：自动化执行错误处理审查的智能体流程

Sun, 18 Oct 2026 08:33:19 +0800

开发者经常要做「错误处理审查」这类事：检查吞异常、裸 except、缺少重试与日志的位置。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。

本文介绍如何在 n8n AI Agent 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

「错误处理审查」Skill 组合用法：和相关技能串成流水线

Sun, 18 Oct 2026 08:32:07 +0800

如果你在代码仓库与终端里反复做错误处理审查，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。

单个技能解决一个环节，把几个技能串起来，才能覆盖一整段工作。本文示范「错误处理审查」与三个相关技能的组合。

Gemini CLI 自定义命令实现「错误处理审查」：TOML 写法与用法

Sun, 18 Oct 2026 08:32:04 +0800

本文介绍如何在 Gemini CLI 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

用 Cline Rules 实现「错误处理审查」：规则文件写法

Sun, 18 Oct 2026 08:31:33 +0800

本文介绍如何在 Cline Rules 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

10 分钟上手「配置一致性检查」Skill：从零到第一次跑通

Sun, 18 Oct 2026 08:30:52 +0800

「配置一致性检查」是开发者的高频任务。它的输入通常是各环境配置文件，期望得到的是差异表与风险说明。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。

这篇是最短路径：不追求完美，只求在 10 分钟内让「配置一致性检查」第一次跑通。

准备（2 分钟）

一份真实但已脱敏的各环境配置文件
一个支持技能或自定义指令的智能体工具（如 Claude Code、Cursor、GPTs、扣子等任一）
一份你认可的差异表与风险说明范例（可选，但很有帮助）

第 1 步：写最小指令（3 分钟）

任务：配置一致性检查
输入：各环境配置文件
步骤：
1. 解析配置为键值
2. 按环境比对
3. 标出缺失与不一致
4. 排除密钥值只比较键
输出：差异表与风险说明，末尾列出需人工确认的内容。
信息不足时先提问，不要编造。

第 2 步：放到工具里（2 分钟）

把上面的内容放进所用工具的规则或技能位置：Claude Code 放进 .claude/skills/config-consistency/SKILL.md（前面补上 name 与 description），Cursor 放进 .cursor/rules/，GPTs 放进 Instructions。具体位置见各平台版本的文章。

在 Claude 应用里启用「错误处理审查」Skill：打包、上传与使用

Sun, 18 Oct 2026 08:28:42 +0800

本文介绍如何在 Claude 应用中的 Skills 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

「复杂度热点分析」Skill 常见问题解答

Sun, 18 Oct 2026 08:28:38 +0800

开发者经常要做「复杂度热点分析」这类事：找出圈复杂度高、改动频繁的文件，作为优先治理对象。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。

项目	说明
技能	复杂度热点分析（`complexity-hotspots`）
作用	找出圈复杂度高、改动频繁的文件，作为优先治理对象
输入	仓库与 git 历史
输出	热点文件排行与治理建议
形态	带脚本
风险	低
适用人群	开发者

1. 「复杂度热点分析」技能和直接写提示词有什么区别？

技能把步骤、格式和约束固定下来，由平台在相关时自动加载；提示词需要每次手动提供，效果依赖当次写法。

把「依赖升级助手」写成 MCP 服务：工具定义与客户端配置

Sun, 18 Oct 2026 08:27:35 +0800

开发者经常要做「依赖升级助手」这类事：按变更日志评估依赖升级影响，分批升级并跑测试。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。

本文介绍如何在 MCP 服务 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

复杂度热点分析 Skill 的 SKILL.md 模板与写作要点

Sun, 18 Oct 2026 08:25:28 +0800

「复杂度热点分析」是开发者的高频任务。它的输入通常是仓库与 git 历史，期望得到的是热点文件排行与治理建议。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。

本文以「复杂度热点分析」为例，逐段讲解 SKILL.md 的写法。SKILL.md 是 Claude Agent Skills 采用的格式：YAML 头 + Markdown 正文，其结构思路也适用于其他平台的规则文件与指令。

LangChain 工具实战：把错误处理审查变成可调用的智能体

Sun, 18 Oct 2026 08:25:24 +0800

本文介绍如何在 LangChain / LangGraph 工具 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

把「重构方案规划」做成 Claude Code Skill：SKILL.md 写法与上手

Sun, 18 Oct 2026 08:23:31 +0800

本文介绍如何在 Claude Code Skill 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

Claude Code Skill 实战：错误处理审查的目录结构与示例

Sun, 18 Oct 2026 08:23:28 +0800

把「错误处理审查」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（代码仓库），按什么顺序处理，交付什么（问题位置与修复建议），哪些事不能做。Skill 就是把这些写下来的载体。

本文介绍如何在 Claude Code Skill 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

配置一致性检查 Skill 避坑指南：写法、权限与输出问题

Sun, 18 Oct 2026 08:21:34 +0800

下面是把「配置一致性检查」做成技能时最常见的 8 个问题，每条都给出改法。

1. 描述写成口号

智能体判断不出何时该用。改为“比对多环境配置文件，找出缺失项与可疑差异；当用户提到配置一致性检查时使用”。

AGENTS.md 小节实战：把类型标注补全变成团队共享流程

Sun, 18 Oct 2026 08:21:32 +0800

「类型标注补全」是开发者的高频任务。它的输入通常是源码文件，期望得到的是带类型标注的代码与检查结果。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。

本文介绍如何在 AGENTS.md 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

在 AGENTS.md 里写「并发问题审查」技能：通用编码智能体都能用

Sun, 18 Oct 2026 08:20:51 +0800

「并发问题审查」是开发者的高频任务。它的输入通常是并发相关代码，期望得到的是风险清单与修复建议。这类有固定流程、又需要一点判断力的工作，很适合封装成智能体 Skill。

本文介绍如何在 AGENTS.md 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

用扣子（Coze）实现「循环依赖拆解」：人设、工作流与发布

Sun, 18 Oct 2026 08:20:01 +0800

把「循环依赖拆解」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（代码仓库），按什么顺序处理，交付什么（依赖环列表与拆解方案），哪些事不能做。Skill 就是把这些写下来的载体。

本文介绍如何在 扣子（Coze）智能体与工作流 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

功能开关清理 Skill 上线前的安全检查要点

Sun, 18 Oct 2026 08:19:05 +0800

把「功能开关清理」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（开关列表与代码），按什么顺序处理，交付什么（清理后的代码与清单），哪些事不能做。Skill 就是把这些写下来的载体。

风险画像

这个技能是纯指令型，主要风险来自输入内容本身（提示注入、敏感信息）与输出被直接使用。属于中等风险：结果会影响业务判断，建议在输出前设置人工审核点。

Agents SDK 实战：几十行代码做一个代码讲解智能体

Sun, 18 Oct 2026 08:17:58 +0800

如果你在代码仓库与终端里反复做代码讲解，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。

本文介绍如何在 OpenAI Agents SDK 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

命名规范审查 Skill 介绍：让智能体按固定流程完成任务

Sun, 18 Oct 2026 08:16:54 +0800

把「命名规范审查」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（代码 diff 或目录），按什么顺序处理，交付什么（命名问题列表与建议名称），哪些事不能做。Skill 就是把这些写下来的载体。

一句话说明

「命名规范审查」技能让智能体按团队命名约定检查变量、函数、文件命名并给出改名建议。你提供代码 diff 或目录，它按固定步骤处理，交付命名问题列表与建议名称。

功能开关清理 Skill 两种写法对比：五行提示词还是完整技能包

Sun, 18 Oct 2026 08:16:32 +0800

如果你在代码仓库与终端里反复做功能开关清理，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。

很多人纠结一开始要不要把技能写得很完整。答案是：先极简，再按需升级。下面对比「功能开关清理」的两种写法。

用 Cursor Rules 实现「文案国际化提取」：.mdc 规则写法与示例

Sun, 18 Oct 2026 08:15:38 +0800

把「文案国际化提取」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（前端或客户端源码），按什么顺序处理，交付什么（资源文件与替换后的代码），哪些事不能做。Skill 就是把这些写下来的载体。

本文介绍如何在 Cursor Rules 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

并发问题审查 Skill 如何与其他技能协作：交接格式与顺序

Sun, 18 Oct 2026 08:15:24 +0800

把「并发问题审查」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（并发相关代码），按什么顺序处理，交付什么（风险清单与修复建议），哪些事不能做。Skill 就是把这些写下来的载体。

单个技能解决一个环节，把几个技能串起来，才能覆盖一整段工作。本文示范「并发问题审查」与三个相关技能的组合。

重构方案规划 Skill 两种写法对比：五行提示词还是完整技能包

Sun, 18 Oct 2026 08:15:23 +0800

很多人纠结一开始要不要把技能写得很完整。答案是：先极简，再按需升级。下面对比「重构方案规划」的两种写法。

用 LangGraph 实现「命名规范审查」：工具定义与智能体代码

Sun, 18 Oct 2026 08:14:58 +0800

本文介绍如何在 LangChain / LangGraph 工具 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

MCP 实战：用工具和提示模板封装魔法数字清理

Sun, 18 Oct 2026 08:14:33 +0800

把「魔法数字清理」交给智能体，难点不在模型能力，而在流程是否说清楚：输入是什么（源码文件），按什么顺序处理，交付什么（重构后的代码），哪些事不能做。Skill 就是把这些写下来的载体。

本文介绍如何在 MCP 服务 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

代码风格迁移 Skill 效果评估方法：样例集、评分维度与迭代

Sun, 18 Oct 2026 08:13:46 +0800

“感觉好用”不足以说明技能有效。下面给出一套轻量的评估方法，用来判断「代码风格迁移」是否达标，以及每次修改后是变好还是变坏。

在 AGENTS.md 里写「命名规范审查」技能：通用编码智能体都能用

Sun, 18 Oct 2026 08:13:03 +0800

开发者经常要做「命名规范审查」这类事：按团队命名约定检查变量、函数、文件命名并给出改名建议。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。

本文介绍如何在 AGENTS.md 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

n8n 实战：自动化执行废弃接口迁移的智能体流程

Sun, 18 Oct 2026 08:13:00 +0800

如果你在代码仓库与终端里反复做废弃接口迁移，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。

本文介绍如何在 n8n AI Agent 上实现这个技能，包括它的形态、示例配置、启用步骤、一次完整的运行过程和常见坑。

无用代码排查 Skill 上线前的安全检查要点

Sun, 18 Oct 2026 08:12:59 +0800

开发者经常要做「无用代码排查」这类事：找出未被引用的函数、文件与依赖，给出可删除清单而不直接删除。每次都从头写提示词，结果时好时坏；把它做成智能体 Skill，就能让智能体每次按同一套步骤执行，输出结构也更稳定。

风险画像

这个技能会执行脚本，需要额外关注脚本的执行范围、依赖来源和对文件系统的影响。风险较低，但输出仍需快速过目再使用。

类型标注补全 Skill 一页检查清单

Sun, 18 Oct 2026 08:11:41 +0800

如果你在代码仓库与终端里反复做类型标注补全，可以考虑把经验沉淀为一个 Skill：写清触发条件、步骤、输出格式和边界，让智能体代劳重复部分，人只负责把关。

把下面的清单保存下来，每次使用或修改「类型标注补全」技能时过一遍。

编写时

description 写清做什么、什么时候用
输入写明需要源码文件，并要求缺信息先提问
步骤为编号列表：识别公共接口、从调用处推断类型、补充标注、运行类型检查器修正
输出写明带类型标注的代码与检查结果的结构
约束包含领域底线与不可逆操作的处理方式
长资料拆到参考文件

上线前

6 类测试输入全部通过
权限按最小范围配置
技能文件中没有密钥和真实个人信息
有负责人和变更记录

每次使用时

输入材料已脱敏或确认可以交给所用平台
观察智能体是否加载了技能
查看“需人工确认”清单
对照原始材料抽查关键信息
风险较低，但输出仍需快速过目再使用

使用后

记录明显的问题样例
输出被大幅修改时，分析原因并考虑改技能
定期检查平台更新是否影响技能

每一步的快速核对

识别公共接口
从调用处推断类型
补充标注
运行类型检查器修正

清单只是底线，深入内容见常见坑与安全审查。

并发问题审查 Skill 避坑指南：写法、权限与输出问题

Sun, 18 Oct 2026 08:11:05 +0800

下面是把「并发问题审查」做成技能时最常见的 8 个问题，每条都给出改法。