generate-link-post

name	generate-link-post
description	为 Astro 博客项目生成 `type: link` 的链接分享文档。 当用户提供一个 URL 并说“生成 link 文档”“写一篇 link”“为这个链接生成文章”“把这个 URL 写成 link 文档”“把这个链接整理成文章”或类似意思时，使用此技能。 技能会抓取 URL 内容，提炼核心信息，生成符合项目风格的 Markdown 文件，并写入 `posts/YYYY/YYYY-MM-DD-link-<slug>.md`。

generate-link-post

为项目 posts/YYYY/*.md 生成 type: link 的链接分享文章。

适用场景

• 用户分享一个 URL，希望将其整理成一篇 link 类型的博客文章。
• 用户说“生成 link 文档”“写一篇 link”“把这个链接写成文章”“为 xxx 生成 link”等。
• 需要基于外部链接快速产出中文摘要、标签和 frontmatter。

输入

用户应提供一个或多个 URL，例如：

https://github.com/excalidraw/excalidraw
https://simonwillison.net/

如果用户没有提供 URL，询问用户要处理的链接地址。

输出

在 posts/YYYY/ 下生成一篇 Markdown 文件（YYYY 为当前年份）：

posts/YYYY/YYYY-MM-DD-link-<slug>.md

其中：

• YYYY-MM-DD 为当前日期。
• <slug> 根据 URL 或页面主题生成，优先使用项目名、仓库名或域名相关的简短英文 slug。
• 如果当天已存在同名文件，覆盖更新，但需告知用户。

执行步骤

1. 抓取并研究 URL 内容

使用 WebFetch 工具抓取用户提供的 URL。若内容不足，可辅以 WebSearch 搜索补充信息。研究时采用 5W2H 通用研究框架对链接指向的项目或内容进行系统分析：

维度	需要回答的问题	应收集的信息示例
What	项目/内容是什么？解决什么问题？	名称、定位、核心功能、输入/输出、主要场景
Why	为什么存在？与竞品相比的核心差异？	诞生背景、痛点、独特卖点、竞品对比、基准数据
Who	维护者背景？社区活跃度？主要贡献者？	组织/团队、核心人物、Star/Fork/Issue、贡献者、用户规模
When	创建时间？最近更新频率？版本节奏？	首次发布时间、最近更新时间、版本历史、发布节奏
Where	技术栈？部署环境？生态位置？	编程语言、框架、运行平台、部署方式、集成生态
How	架构设计？关键模块？数据流？	系统架构、核心组件、工作流程、关键实现原理
How much	许可证限制？维护成本？接入门槛？	许可证类型、商业友好度、硬件/资源要求、安装/使用成本

5W2H 的研究结果直接作为 link 文档正文素材，并从中提取 frontmatter 所需信息（标题、项目名称、核心描述、标签候选等）。

如果 URL 无法访问或抓取失败，告知用户失败原因，并停止后续步骤。

2. 风格约定

Link 文档应遵循以下风格：

• 标题格式："<名称> - <一句话描述>"，中文为主，例如 "Excalidraw - 开源手绘风格虚拟白板"。
• 开篇：首段用 1–2 句话概括项目/链接是什么、解决什么问题，项目名加粗。
• 章节标题：使用三级标题 ###；5W2H 维度标题格式为 ### What｜是什么、### Why｜为什么值得关注 等。
• 列表使用：核心能力、技术栈、生态集成等信息优先使用无序列表呈现；列表项中可用 **粗体** 突出关键词。
• 段落长度：每个 5W2H 维度控制在 1–3 段，全文保持简洁（通常 40–80 行）。
• 结尾：用一句推荐/总结语引导读者访问原链接。
• 语言：全文使用中文；技术术语、项目名、API 名、文件名等保留英文。
• 图片（可选）：如需配图，使用相对路径 /images/YYYY/...。

3. 生成 link 文档

Frontmatter 要求

---
type: link
title: "<中文标题>"
date: YYYY-MM-DD HH:MM:SS +0800
tags: [<标签列表>]
linkUrl: <用户提供的 URL>
---

说明：

• title 应为中文，突出链接主题，例如 "Excalidraw - 开源手绘风格虚拟白板"。
• date 使用当前日期时间，格式为 YYYY-MM-DD HH:MM:SS +0800。
  • 固定采用北京时间（东八区）。如果获取到的当前时间是 UTC，必须先加上 8 小时再写入，避免把 UTC 时间直接填成 +0800。
  • 例如：UTC 时间为 2026-06-27 01:09:57，则应写成 date: 2026-06-27 09:09:57 +0800。
• linkUrl 为用户提供的原始 URL。
• tags 控制在 5–10 个，按以下规则生成。

tags 生成规则

1. 推断标签：根据链接主题、技术栈和核心概念，推断出一组候选标签。优先使用小写英文标签（如 excalidraw、whiteboard、open-source、collaboration），必要时可混合中文标签。
2. 复用已有标签：读取项目根目录的 tags.txt，在候选标签中优先使用已存在的标签。
3. 追加新标签：如果某个候选标签在 tags.txt 中不存在，则将其追加到 tags.txt 文件末尾，每个标签独占一行。
4. 最终 tags 字段按语义或字母顺序排列。

注意：不要重复添加 tags.txt 中已有的标签；追加新标签时不要在行尾添加多余标点或空行。

正文要求

正文直接基于第 1 步的 5W2H 研究结果组织，通常包含以下章节（可根据链接内容增删，某维度信息不足时可跳过）：

1. 执行摘要 / 简介：用 1–2 句话概括这个链接是什么、解决什么问题、为什么值得关注（对应 What + Why 的核心）。
2. What｜是什么：项目/内容的核心定位、主要功能、输入输出、产品形态。
3. Why｜为什么值得关注：诞生背景、解决的痛点、与竞品的差异、核心亮点、关键数据/基准表现。
4. Who｜谁在维护：团队/组织背景、社区规模、活跃度、主要贡献者、用户群体。
5. When｜时间线：创建时间、版本节奏、最近更新、发展趋势。
6. Where｜技术栈与生态：技术栈、运行环境、部署方式、集成生态、在工具链中的位置。
7. How｜如何工作（如果适用）：关键架构、核心模块、数据流或实现原理的简明说明。
8. How much｜成本与门槛：许可证类型及商业友好度、硬件/资源要求、安装或使用成本、接入门槛。
9. 总结 / 访问链接：一句话总结并引导读者访问原链接。

语言要求：

• 全文使用中文。
• 语气为简洁、信息密度适中的技术博客风格。
• 技术术语可保留英文。
• 博客文章应简洁可读，每个 5W2H 维度通常用 1–3 段呈现，避免写成冗长技术报告。

4. 写入前确认

在调用 Write 工具写入文件之前，必须向用户展示：

• 生成的文件路径
• 生成的 frontmatter
• 正文的简要摘要或完整内容

并明确询问：

是否将这篇 link 文档写入 <文件路径>？

只有用户确认后，才执行 Write。

5. 写入文件

用户确认后，使用 Write 工具创建或覆盖文件。

6. 不处理 git 提交

本技能不执行 git add、git commit 或 git push。 如果用户要求提交，婉拒并说明：

Link 文档已生成。如需提交，请单独使用 git 命令或告诉我帮你执行提交。

边界情况

• URL 无效或无法访问：告知用户失败原因，停止处理。
• 用户提供多个 URL：依次为每个 URL 生成一篇 link 文档，每篇都需确认。
• 当天已存在同名 link 文件：覆盖更新，但需告知用户这是覆盖操作。
• 用户未提供 URL：询问 URL，不自行猜测。
• URL 指向非网页内容（如 PDF、图片）：尝试抓取，如失败则告知用户。

示例

用户输入：

https://github.com/excalidraw/excalidraw

或

为 https://github.com/excalidraw/excalidraw 生成 link 文档

技能行为：

1. 使用 WebFetch 抓取 GitHub 页面内容，并以 5W2H 框架研究项目（What/Why/Who/When/Where/How/How much）。
2. 生成 posts/2026/2026-06-26-link-excalidraw.md，正文按 5W2H 结构组织，遵循本技能的风格约定。
3. 向用户展示 frontmatter 和正文摘要，询问是否写入。
4. 用户确认后写入文件。

项目约定

• 本项目为 Astro 博客，站点域名为 wangjunjian.com。
• Link 文档统一放在 posts/YYYY/，文件名格式为 YYYY-MM-DD-link-<slug>.md。
• 内容类型使用 type: link。
• 日期时区统一使用 +0800。