问题的由来

设计后台服务绕不开建表，表和表之间又互相关联：user、order，order 要引用 user。于是一个不起眼但天天要面对的问题冒出来：主键怎么命名？

我倾向过 user_id 这种带表名的命名——user 表的主键就叫 user_id，order 表引用它的列也叫 user_id。理由很朴素：每个字段一眼可辨，order.user_id 指向谁不用翻表结构。

但”一眼可辨”这四个字经得起推敲吗？我把这个问题拆开来想了一遍。先把结论交底：表名冻结、术语稳定的系统——金融核心、内部管理系统这类——我会选带表名的主键；业务词汇三年一换的互联网产品，我会选 id。为什么，一个维度一个维度说。

先把两种做法摆清楚

两种做法分别长这样：

• id 命名：user 表主键叫 id，order 表引用列叫 user_id——两边不对称。Rails、Django、MyBatis-Plus 的约定生态都是这么默认的。
• 表名命名：user 表主键就叫 user_id，order 表引用列也叫 user_id——同名对称。金融、电信这类传统企业系统里很常见。

顺带消个歧：这是主键列的命名问题，不是”代理键 vs 自然键”（用自增 id 还是用身份证号当主键）之争——那是另一个话题。它比看上去微妙的地方在于，user_id 这个词在两种做法里含义不同：一边是 user 表的主键，一边是引用列的通用名字。很多人在这个话题里吵的其实是两件不同的事。

同一张表引用两次的时候

想清楚的第一步，是撞上一个现实场景：同一张表引用同一张表两次。订单有买家和卖家，审批流有创建人和审批人，转账有付款方和收款方——全都指向 user 表。

深圳暑假遛娃攻略

深圳暑假亲子室内场馆打卡指南：旧地重游 + 全新探索并行，全程室内避暑，兼顾研学与遛娃。

策略：大多免费免预约，少数按需提前预约；利用暑假慢慢走完所有点位。

📋 全部点位速查表

🏛️ 各场馆详情

1️⃣ 深圳科学技术馆（光明新馆）

• 🎫 门票：50元/成人，16岁以下32元，1.2m以下免费
• 📝 预约：需要预约
• 🚇 交通：6号线光明站C/D出口
• ⏰ 开放时间：
  • 周二至周五 10:00-17:00
  • 周六至周日 09:30-18:30（夏季）
  • 周一闭馆

2️⃣ 深圳市科学馆（福田）

Agent Teams 让多个 Claude Code 实例并行工作并通过共享任务列表相互协调。与 subagents 不同，agent teams 中的队友可以直接相互通信、协作和分享发现，适合需要团队协作的复杂任务。

本文将详细介绍 Agent Teams 的启用方式、使用方法、最佳实践以及与 Subagents 的区别。

Agent Teams 概述

什么是 Agent Teams

Agent Teams 是一组并行工作的 Claude Code 实例，通过共享任务列表协调工作。每个队友都是完整的、独立的 Claude Code 会话，拥有自己的 context window。

核心组件：

与 Subagents 的区别

Agent Teams 和 Subagents 都支持并行工作，但运作方式不同：

Subagents 是 Claude Code 中处理特定类型任务的专门 AI 助手。每个 subagent 在自己独立的 context window 中运行，具有自定义系统提示、特定的工具访问权限和独立的权限控制。当 Claude 遇到与 subagent 描述相匹配的任务时，它会委托给该 subagent，subagent 独立工作后返回结果。

本文将从创建方法、使用场景和最佳实践三个维度，全面介绍 Claude Code Sub-Agents 的使用。

如何创建 Sub-Agent

使用 /agents 命令（推荐方式）

/agents 命令提供了交互式界面来管理 subagents，这是推荐的创建方式：

1

/agents

在交互界面中可以：

• 查看所有可用的 subagents（内置、用户、项目和插件）
• 使用引导式设置或 Claude 生成创建新的 subagents
• 编辑现有 subagent 配置和工具访问权限
• 删除自定义 subagents

创建步骤示例：

1. 选择 Create new agent

2. 选择范围：User-level（用户级）或 Project-level（项目级）

3. 选择 Generate with Claude 让 Claude 自动生成配置

4. 描述你的 subagent，例如：

   1 2	A code improvement agent that scans files and suggests improvements for readability, performance, and best practices.

5. 选择工具权限（只读审查者只需选择 Read-only tools）

6. 选择模型（Sonnet 平衡能力和速度，Haiku 更快更便宜）

7. 保存后立即可用，无需重启

基础概念

什么是 Skills？
Skills 是 Claude Code 的扩展机制，让你可以创建、管理和分享自定义能力。每个 Skill 是一个包含 SKILL.md 文件的目录，Claude 会将其添加到工具箱中。

核心价值：

• 自动化重复任务
• 添加领域专业知识
• 强制执行代码标准和最佳实践
• 加速项目脚手架和代码生成

文件结构

1
2
3
4
5
6

~/.claude/skills/<skill-name>/
├── SKILL.md          # 必需，主指令文件
├── templates/        # 可选，模板文件
├── examples/         # 可选，示例输出
├── scripts/          # 可选，脚本文件
└── docs/             # 可选，详细参考文档

Skills 存储位置：

本文为基于 JaCoCo 源码二次开发的全流程方案，旨在实现类局部修改后保留未改动方法历史覆盖率，仅失效改动方法覆盖率的核心诉求，兼顾 JaCoCo 原生正确性原则与业务实用性。

一、核心目标与不可突破原则

1.1 核心开发目标

• 类局部修改（方法 / 代码块修改）时，未改动方法的历史覆盖率完全复用，改动方法覆盖率清零并重新统计；
• 完全兼容 JaCoCo 原生能力：插桩方式（动态 / 离线）、覆盖率维度、dump 文件格式、构建插件（Maven/Gradle）；
• 坚守正确性底线：仅当方法字节码逻辑完全未变时才复用覆盖率，杜绝错误数据。

1.2 不可突破原则

• 正确性原则：复用数据必须基于方法逻辑一致性，方法体改动则覆盖率强制失效；
• 向下兼容原则：改造后 JaCoCo 可解析原生 dump 文件，原生 JaCoCo 可解析改造后文件（降级兼容）；
• 无侵入原则：业务侧无感知，使用方式与原生 JaCoCo 一致，新增开关控制功能。

1.3 核心改造思想

原生 JaCoCo 以 类级别 ClassID 绑定覆盖率数据，类变更则全量失效；改造后下沉为 方法级别 MethodID 绑定，实现方法级粒度的失效与复用，核心逻辑如下：

• 覆盖率数据存储结构从 ClassID + 全局探针ID → ClassID + MethodID + 方法内局部探针ID

最近使用 Guava 中 RateLimiter.getRate() 方法时遇到了一个反直觉的现象，这里贴出来给大家分享一下。

现象

我们先看下下面这段代码

1
2
3
4
5

public static void main(String[] args) {
    RateLimiter rateLimiter = RateLimiter.create(10.0D);
    double rate = rateLimiter.getRate();
    System.out.println(rate);
}

直觉上最终会输出 10.0，实际最终也是输出了 10.0。

可是如果我们将上述代码中的 10.0D 变为 15.0D，结果会输出什么呢？

1
2
3
4
5

public static void main(String[] args) {
    RateLimiter rateLimiter = RateLimiter.create(15.0D);
    double rate = rateLimiter.getRate();
    System.out.println(rate);
}

执行后输出的值竟然是 14.999999999999998。看到这个结果我觉得非常的奇怪，毕竟直觉告诉我应该输出 15.0 才对。

刨根问底

看到这样的现象，我们首先就要从源码上分析一下，看一下 Guava 内部是如何处理的。

JaCoCo 简介

JaCoCo should provide the standard technology for code coverage analysis in Java VM based environments. The focus is providing a lightweight, flexible and well documented library for integration with various build and development tools.

JaCoCo 要为基于 Java VM 的环境中的代码提供覆盖率分析标准技术，重点是提供一个轻量、灵活且文档齐全的库，以便与各种构建和开发工具集成。

功能特性

• 指令（C0）、分支（C1）、行、方法、类型、圈复杂度的覆盖率分析；
• 基于 Java 字节码，即使没有源码依然可以运行；
• 支持 on-the-fly 模式，可以通过 javaagent 便捷地集成，也可以通过 API 来自定义类装载器进行集成；
• 与框架无关，可以对基于 Java VM 的应用程序顺利的集成；
• 与所有已发布的 Java 版本兼容；
• 支持不同的 JVM 语言；
• 可以生成多种格式的报告（HTML、XML、CSV）；
• 支持远程协议和 JMX 控制，可以在任何时间点来进行覆盖率数据的存储；

使用

下载完 JaCoCo 之后会得到几个 jar 包，其中 jacocoagent.jar 和 jacococli.jar 是我们比较关注的。

• jacocoagent.jar 是 JVM 应用程序启动时的代理
• jacococli.jar 是生成覆盖率报告、合并 dump 文件的命令行工具

jacocoagent

Java Agent 的原理可以阅读 java.lang.instrument.Instrumentation 这个类，这里先介绍 jacocoagent 的使用方法。

最近在做基于 JaCoCo 的代码覆盖率工具，了解到了 javaagent 相关的一些知识点。

javaagent 是什么？

javaagent 是 java 命令的一个参数选项，可以用于加载 Java 语言的代理。

那么这个参数加载的 Java 语言的代理需要满足什么样的规范呢？

1. 代理 jar 包中的 MANIFEST.MF 文件需指定 Premain-Class；
2. Premain-Class 指定的类中必须实现 premain 方法。

zsh 可能是目前最好用的终端。

安装

Mac OS

macOS 自带 zsh，并且当前最新版本 macOS 默认终端即为 zsh

Ubuntu

使用 sudo apt install zsh 命令即可安装 zsh

CentOS

使用 sudo yum install zsh 命令即可安装 zsh

在安装好 zsh 之后，第一次使用的时候，会有如下的提示：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

This is the Z Shell configuration function for new users,
zsh-newuser-install.
You are seeing this message because you have no zsh startup files
(the files .zshenv, .zprofile, .zshrc, .zlogin in the directory
~).  This function can help you with a few settings that should
make your use of the shell easier.

You can:

(q)  Quit and do nothing.  The function will be run again next time.

(0)  Exit, creating the file ~/.zshrc containing just a comment.
     That will prevent this function being run again.

(1)  Continue to the main menu.

(2)  Populate your ~/.zshrc with the configuration recommended
     by the system administrator and exit (you will need to edit
     the file by hand, if so desired).

--- Type one of the keys in parentheses ---