Skip to content

Commit 9693847

Browse files
committed
docs: 规范化 zhuanlan 目录文章排版,优化 Harness Engineering 文章
- zhuanlan: 修复中英文间距、错别字(优惠卷→优惠券)、错链、语病、引号规范化 - harness-engineering: 修复漏字(引入)、渐进式披露部分补充 Agent Skills 关联与链接
1 parent b7b3f1a commit 9693847

File tree

7 files changed

+47
-45
lines changed

7 files changed

+47
-45
lines changed

docs/ai/agent/harness-engineering.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ LangChain 的 Vivek Trivedi 在《The Anatomy of an Agent Harness》里把这个
7272
| 知道自己做对了没有 | 沙箱环境 + 测试工具 + 浏览器自动化 | **验证闭环** |
7373
| 在长任务中保持连贯 | 上下文压缩、记忆文件、进度追踪 | **上下文管理** |
7474

75-
把这些模型做不了但你希望 Agent 能做到”的事情一个个补上,就得到了 Harness 的核心组件。LangChain 把这件事拆解为五个子系统:文件系统(持久化)、Bash 执行(通用工具)、沙箱环境(安全隔离)、记忆机制(跨会话积累)、上下文压缩(对抗衰减)。
75+
把这些模型做不了但你希望 Agent 能做到”的事情一个个补上,就得到了 Harness 的核心组件。LangChain 把这件事拆解为五个子系统:文件系统(持久化)、Bash 执行(通用工具)、沙箱环境(安全隔离)、记忆机制(跨会话积累)、上下文压缩(对抗衰减)。
7676

7777
## Harness 进阶
7878

@@ -201,7 +201,7 @@ Harness Engineering 相关的高频面试问题整理在下面,方便你快速
201201

202202
## 还没有答案的问题
203203

204-
Harness Engineering 是一个快速发展的领域,仍有许多未解的问题。了解这些不知道”同样重要——面试时能展现你的思考深度。
204+
Harness Engineering 是一个快速发展的领域,仍有许多未解的问题。了解这些不知道”同样重要——面试时能展现你的思考深度。
205205

206206
| 问题 | 现状 | 谁在关注 |
207207
| ------------------------------- | ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -218,7 +218,7 @@ Harness Engineering 是一个快速发展的领域,仍有许多未解的问题
218218
- 棕地项目(Brownfield):在已有代码库上改造,有历史架构、技术债、遗留逻辑的约
219219
束。就像在老旧城区搞翻新,到处是管线不能随便动。
220220

221-
OpenAI、Anthropic、Stripe、Hashimoto 这些成功案例,全部是在全新项目上从零搭Harness。但现实中绝大多数团队面对的是已经跑了多年的代码库——怎么把 Harness 入一个十年历史、没有架构约束、到处是技术债的项目?目前没有任何公开方法论。
221+
OpenAI、Anthropic、Stripe、Hashimoto 这些成功案例,全部是在全新项目上从零搭Harness。但现实中绝大多数团队面对的是已经跑了多年的代码库——怎么把 Harness 引入一个十年历史、没有架构约束、到处是技术债的项目?目前没有任何公开方法论。
222222

223223
## 总结
224224

@@ -254,7 +254,9 @@ OpenAI、Anthropic、Stripe、Mitchell Hashimoto、Martin Fowler,这五个团
254254

255255
OpenAI 的 `AGENTS.md` 只有大约 100 行,作用类似于目录,指向 `docs/` 目录下更深层的设计文档、架构图、执行计划和质量评级。这是**渐进式披露**的实际运用——先把最关键的信息放进来,需要什么再加载什么。
256256

257-
就像你到一个新城市,不需要把整本旅游指南背下来。给你一张简明的地图(核心规则),然后告诉你”想了解这个景点的详细信息,翻到第 X 页”就够了。
257+
就像你到一个新城市,不需要把整本旅游指南背下来。给你一张简明的地图(核心规则),然后告诉你“想了解这个景点的详细信息,翻到第 X 页”就够了。
258+
259+
> **📌 渐进式披露的一个具体实现:Agent Skills**。Agent Skills 的核心机制就是“元数据常驻,正文按需加载”——每个 Skill 只在上下文中保留简短的名称和描述(几十个 Token),详细规则和执行流程只在触发时才动态注入推理上下文。这本质上和 OpenAI 的 `AGENTS.md` 当目录用是同一个思路,只不过 Skills 把这个模式进一步标准化了。详细介绍可以参考这篇:[Agent Skills 详解:是什么?怎么用?和 Prompt、MCP 有什么区别?](https://javaguide.cn/ai/agent/skills.html)
258260
259261
#### 架构约束不能写在文档里,必须靠工具强制执行
260262

docs/zhuanlan/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: 星球专属优质专栏概览
3-
description: JavaGuide知识星球专属专栏汇总,包含Java面试指北、手写RPC框架、源码解读等优质学习资源。
3+
description: JavaGuide 知识星球专属专栏汇总,包含 Java 面试指北、手写 RPC 框架、源码解读等优质学习资源。
44
category: 知识星球
55
---
66

@@ -9,8 +9,8 @@ category: 知识星球
99
- [《Java 面试指北》](./java-mian-shi-zhi-bei.md) : 与 JavaGuide 开源版的内容互补!
1010
- [⭐AI 智能面试辅助平台 + RAG 知识库](./interview-guide.md):基于 Spring Boot 4.0 + Java 21 + Spring AI 2.0 开发。非常适合作为学习和简历项目,学习门槛低,帮助提升求职竞争力,是主打就业的实战项目。
1111
- [《后端面试高频系统设计&场景题》](./back-end-interview-high-frequency-system-design-and-scenario-questions.md) : 包含了常见的系统设计案例比如短链系统、秒杀系统以及高频的场景题比如海量数据去重、第三方授权登录。
12-
- [《手写 RPC 框架》](./java-mian-shi-zhi-bei.md) : 从零开始基于 Netty+Kyro+Zookeeper 实现一个简易的 RPC 框架。
13-
- [《Java 必读源码系列》](./source-code-reading.md):目前已经整理了 Dubbo 2.6.x、Netty 4.x、SpringBoot 2.1 等框架/中间件的源码
12+
- [《手写 RPC 框架》](./handwritten-rpc-framework.md) : 从零开始基于 Netty + Kryo + Zookeeper 实现一个简易的 RPC 框架。
13+
- [《Java 必读源码系列》](./source-code-reading.md):目前已经整理了 Dubbo 2.6.x、Netty 4.x、Spring Boot 2.1 等框架/中间件的源码
1414
- ……
1515

1616
欢迎准备 Java 面试以及学习 Java 的同学加入我的[知识星球](../about-the-author/zhishixingqiu-two-years.md),干货非常多!收费虽然是白菜价,但星球里的内容比你参加几万的培训班质量还要高。

docs/zhuanlan/back-end-interview-high-frequency-system-design-and-scenario-questions.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ category: 知识星球
1010

1111
### 为什么你需要这份小册?
1212

13-
近年来,国内技术面试"越来越卷"。越来越多的公司(阿里、美团、字节、腾讯等)开始在面试中考察 **系统设计****场景问题**,以此来更全面地考察求职者的综合能力——不论是校招还是社招。
13+
近年来,国内技术面试越来越卷。越来越多的公司(阿里、美团、字节、腾讯等)开始在面试中考察 **系统设计****场景问题**,以此来更全面地考察求职者的综合能力——不论是校招还是社招。
1414

15-
> 很多同学八股文背得滚瓜烂熟,但一遇到"如何设计一个秒杀系统?"这类开放性问题就懵了。
15+
> 很多同学八股文背得滚瓜烂熟,但一遇到如何设计一个秒杀系统?这类开放性问题就懵了。
1616
1717
**系统设计和场景题的考察特点**
1818

@@ -52,7 +52,7 @@ category: 知识星球
5252
| **如何设计一个站内消息系统?** | 消息推送、未读数统计、WebSocket、消息队列 |
5353
| **如何设计微博 Feed 流/信息流系统?** | 推拉模型、Timeline、智能推荐、读写扩散、缓存策略 |
5454
| **如何设计一个排行榜?** | Redis Sorted Set、实时更新、分页查询、海量数据排序 |
55-
| **几种典型的系统设计案例(整理补充)** | 点赞、优惠卷、红包等综合案例分享 |
55+
| **几种典型的系统设计案例(整理补充)** | 点赞、优惠券、红包等综合案例分享 |
5656

5757
### 🎯 高频场景题
5858

docs/zhuanlan/handwritten-rpc-framework.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,15 +6,15 @@ category: 知识星球
66

77
## 介绍
88

9-
**《手写 RPC 框架》** 是我的[知识星球](../about-the-author/zhishixingqiu-two-years.md)的一个内部小册,我写了 12 篇文章来讲解如何从零开始基于 Netty+Kyro+Zookeeper 实现一个简易的 RPC 框架。
9+
**《手写 RPC 框架》** 是我的[知识星球](../about-the-author/zhishixingqiu-two-years.md)的一个内部小册,我写了 12 篇文章来讲解如何从零开始基于 Netty + Kryo + Zookeeper 实现一个简易的 RPC 框架。
1010

1111
麻雀虽小五脏俱全,项目代码注释详细,结构清晰,并且集成了 Check Style 规范代码结构,非常适合阅读和学习。
1212

1313
## 内容概览
1414

1515
![](https://oss.javaguide.cn/github/javaguide/image-20220308100605485.png)
1616

17-
通过这个简易的轮子,你可以学到 RPC 的底层原理和原理以及各种 Java 编码实践的运用。你甚至可以把它当做你的毕设/项目经验的选择,这是非常不错!对比其他求职者的项目经验都是各种系统,造轮子肯定是更加能赢得面试官的青睐。
17+
通过这个简易的轮子,你可以学到 RPC 的底层原理以及各种 Java 编码实践的运用。你甚至可以把它当做你的毕设或项目经验,这是非常不错的选择!对比其他求职者的项目经验都是各种系统,造轮子肯定是更加能赢得面试官的青睐。
1818

1919
- GitHub 地址:[https://github.com/Snailclimb/guide-rpc-framework](https://github.com/Snailclimb/guide-rpc-framework)
2020
- Gitee 地址:[https://gitee.com/SnailClimb/guide-rpc-framework](https://gitee.com/SnailClimb/guide-rpc-framework)

0 commit comments

Comments
 (0)