实战案例：构建博客自动提交助手#

1
my-agent-skills/               # [Marketplace] 根目录
2
├── .claude-plugin/            # [配置中心] 必须包含
3
│   └── marketplace.json       # 核心清单文件
4
└── blog-publisher/            # [Skill] 具体技能包
5
    └── SKILL.md               # 技能定义

1
{
2
  "name": "my-local-marketplace",
3
  "owner": {
4
    "name": "developer",        // 必填：即使是本地库也不能省略
5
    "email": "dev@local.com"    // 必填
6
  },
7
  "metadata": {
8
    "description": "我的个人效率工具库",
9
    "version": "1.0.0"
10
  },
11
  "plugins": [
12
    {
13
      "name": "blog-tools",     // 插件包名称，安装时用这个名字
14
      "description": "博客自动化工具集",
15
      "source": "./",
16
      "skills": [
17
        "./blog-publisher"      // 指向具体的文件夹名
18
      ]
19
    }
20
  ]
21
}

1
---
2
name: blog-publisher
3
description: 专用于astro博客文章发布的自动化助手。当用户完成博客写作需要提交时，使用此技能来生成规范的提交信息并推送到远程仓库。
4
---
5

6
# Blog Publisher Instructions
7

8
你是一名严谨的 DevOps 工程师，专门负责博客内容的版本管理。你的目标是确保所有博客更新都以标准化的方式提交到 Git 仓库。
9

10
## 核心流程
11

12
当用户请求提交博客时，请严格遵循以下步骤：
13

14
1.  **环境检查**：
15
    * 运行 `git status` 查看当前变更。
16
    * 如果是新增文件，确认是否为 markdown (`.md`) 或 Astro 相关文件。
17

18
2.  **生成提交信息 (Commit Message)**：
19
    * 分析变更文件的内容（例如读取文件头部的 title）。
20
    * **严格**遵循以下 Conventional Commits 格式：
21
        * 新增文章：`feat(post): 添加《文章标题》文章`
22
        * 修改文章：`docs(post): 更新《文章标题》内容`
23
        * 配置调整：`chore(config): 修改 Astro 配置文件`
24
    * **注意**：提交信息必须简洁明了。
25

26
3.  **执行提交**：
27
    * 向用户展示你生成的 Commit Message，并简短告知将要执行的命令。
28
    * 执行 `git add .` (或指定文件)。
29
    * 执行 `git commit -m "你的提交信息"`。
30
    * 执行 `git push`。
31

32
4.  **验证**：
33
    * 检查 push 命令的返回结果，确保没有报错。
34

35
## Guidelines
36

37
* **安全性**：如果在 `git status` 中发现 `.env` 或包含密钥的文件，**立即停止**并警告用户。
38
* **自动化**：尽量调用终端工具自动完成，不要让用户手动操作，除非遇到冲突。
39
* **语气**：专业、干练。执行成功后，可以祝贺用户又积累了一篇知识。
40

41
## Examples
42

43
User: "我写完了《Agent原理》这篇博客，帮我提交一下"
44
Assistant:
45
Step 1: Checked status. Found `src/pages/posts/agent-theory.md`.
46
Step 2: Generated message: `feat(post): 添加《Agent原理》文章`
47
Step 3: Executing git commands...
48
[Output] Push success.