feat: 更新write skill
This commit is contained in:
parent
daad0c7d69
commit
7ffa34067c
@ -5,7 +5,7 @@ description: 为 llm-to-agent 的《Agent进阶专题》系列创作中文文章
|
||||
|
||||
# 创作 Agent 系列博客
|
||||
|
||||
为《Agent进阶专题》输出一篇 Hexo Markdown 文章到 `blog/` 下。**源码是唯一事实来源,只写已实现的行为。**
|
||||
为《Agent进阶专题》输出一篇 Hexo Markdown 文章到 `/Users/liyanyan/study/hexo-blog/source/_posts/agent/`。**源码是唯一事实来源,只写已实现的行为。**
|
||||
|
||||
---
|
||||
|
||||
@ -14,9 +14,9 @@ description: 为 llm-to-agent 的《Agent进阶专题》系列创作中文文章
|
||||
### 工作流程
|
||||
|
||||
1. `git rev-parse --show-toplevel` 定位项目根目录。
|
||||
2. 用 `git show` / `git diff` 读取目标变更;读已有 `blog/*.md` 确定编号、术语、避免重复。
|
||||
2. 用 `git show` / `git diff` 读取目标变更;读取 `/Users/liyanyan/study/hexo-blog/source/_posts/agent/*.md` 确定编号、术语、避免重复。
|
||||
3. 确定:阶段(P0/P1/P2)、阶段内序号、中文标题、英文 slug。
|
||||
4. 只新建一个 `blog/2026-PX-0X-slug.md`,不覆盖已有文件。
|
||||
4. 只在 `/Users/liyanyan/study/hexo-blog/source/_posts/agent/` 新建一个 `2026-PX-0X-slug.md`,不覆盖已有文件。
|
||||
|
||||
### 文件名与元信息
|
||||
|
||||
@ -71,6 +71,25 @@ permalink: /YYYY/agent/slug/
|
||||
- 导读/概念类 ~1000 中文字符;实现类按需,讲清即止。
|
||||
- 2-4 个短章节即可,不为完整而堆章节。
|
||||
|
||||
### Extension 实现类文章
|
||||
|
||||
默认按以下主线组织:
|
||||
|
||||
```text
|
||||
能力介绍 → 实现思路 → setup 行为 → start 行为 → stop 行为 → 抓手 → 下节引子
|
||||
```
|
||||
|
||||
- 这是写作顺序,不是固定模板;根据源码实际行为扩展、合并或删除小节。
|
||||
- 没有 `start` / `stop` 时直接省略,不创建空章节。
|
||||
- “能力介绍”说明当前插件解决什么问题、提供什么结果,以文字为主,不在这里罗列接口和方法。
|
||||
- “实现思路”说明数据模型、关键取舍和整体流程,以文字为主;路径、数据结构、内部方法等细节不要各自拆节。
|
||||
- 代码尽量集中在 `setup`、`start`、`stop` 和“抓手”中。前两节只在没有代码就难以说清时放一段短示意。
|
||||
- “抓手”专门说明当前插件**对外暴露**的命名能力。先用“对外暴露一个名为 `xxx` 的能力,它的契约是 `XxxService`”点题,再展示契约并逐项解释其中的字段和方法。
|
||||
- 不重复介绍所有插件通用的注册、获取和消费方式;除非某个插件的连接方式确有特殊之处,否则省略 `context.add/get` 等样板代码。
|
||||
- 解释契约时只写当前文章已经建立的概念。某个字段或方法涉及后续主题时,只说明它现在提供的结果,不点名尚未介绍的插件,也不展开后续流程。
|
||||
- 当前插件没有对外能力时,省略“抓手”,不要为了凑结构扩展概念。
|
||||
- 下节引子只承接一个最自然的后续能力。
|
||||
|
||||
### 叙事方式
|
||||
|
||||
- 从读者能理解的场景切入,不假定读者读过前文。
|
||||
@ -143,8 +162,8 @@ permalink: /YYYY/agent/slug/
|
||||
|
||||
### 代码呈现
|
||||
|
||||
- 代码是正文主体,文字只是必要说明。
|
||||
- 按实现步骤拆分代码块,每块配一行解释。
|
||||
- 实现类文章中,前两节以文字为主,代码集中到生命周期与“抓手”。
|
||||
- 按生命周期或对外能力拆分代码块,每块配一行解释。
|
||||
- 可在代码块之间穿插截图验证运行结果。
|
||||
|
||||
### 结尾
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user