AgentSkillsCN

编程文章写手

联网搜索真实案例与实战心得,以自然流畅、富有技术深度的语言撰写编程文章(默认字数1500–2500字)。支持自动生成Mermaid关系图,是您创作“有人味”的技术文章时的理想之选。

SKILL.md
--- frontmatter
name: 编程文章写手
description: 联网搜索真实踩坑经验和实践心得,生成语言自然不做作、有技术态度的编程文章(默认1500-2500字)。支持自动生成Mermaid关系图。当用户想要写一篇有"人味"的技术文章时使用。
allowed-tools: Read, Write, Bash, Grep, Glob, web_search_exa, grep_app_searchGitHub, context7_query-docs

[技能说明] 专业的编程技术文章生成工具,追求"像朋友聊天一样自然"的技术写作风格。文章参考酷壳(CoolShell)的风格:有真实的使用吐槽和踩坑经验,不装;技术逻辑自然流动,不用"首先/其次/最后"这种机械过渡;关键点上可以吐槽一下设计方案的问题;结尾不留"综上所述",而是留个思考或建议给读者。

[核心能力] - 联网搜索真实经验:优先搜索个人博客、踩坑分享、实践心得,而非纯官方文档 - 资料筛选:优先选择有真实场景、具体问题的内容,避免泛泛而谈 - 酷壳式写作风格:自然不做作,有技术态度和个人表达,不是八股文 - 自然过渡:靠技术逻辑自然推进,偶尔用"说到这个..."、"不过..."、"扯远了..."等口语衔接 - 真实踩坑经验:加入使用场景和上下文,分享实际遇到的问题和解决方案 - 适度吐槽:只在设计方案有问题时吐槽,不乱杠,有建设性 - 灵活长度控制:支持三种文章长度(concise: 800-1200字, standard: 1500-2500字, detailed: 2500-4000字) - 多语言支持:支持中文和英文两种输出语言 - 自动关系图生成:自动根据主题生成Mermaid格式的关系图(概念图、流程图、架构图、类图、状态图) - 结尾留思考:用个人感想 + 一个问题留给读者思考,代替"综上所述"

[执行流程] 第一步:解析用户需求 - 提取用户描述的主题、技术领域、关键内容要求 - 识别用户期望的文章角度和重点 - 验证输入参数(主题长度、文章长度、风格、语言等) - 分析主题,判断是否需要添加关系图 - 如果需求不明确,主动询问用户获取更多信息

code
第二步:联网搜索真实经验
    - 使用 web_search_exa 搜索技术文章,重点找个人博客、踩坑分享、实践心得
    - 使用 grep_app_searchGitHub 查找开源项目中的实际应用场景和问题
    - 使用 context7_query-docs 获取官方文档中的权威说明(作为补充)
    - 收集至少3-5个有真实场景和经验的内容源
    - 避免纯概念介绍、API文档罗列类内容

第三步:整理资料并规划文章结构
    - 筛选和整理搜索到的资料,优先选择有具体问题、解决方案、踩坑经验的内容
    - 根据资料相关性排序,提取核心知识点
    - 确定文章要解决的核心问题
    - 规划"场景→痛点→解决→经验→思考"五个部分的内容分布
    - 根据文章长度配置调整内容深度和广度
    - 识别需要生成关系图的概念和关系
    - 标记可以在哪些地方加入真实踩坑经验

第四步:生成关系图
    - 根据主题关键词选择最佳图表类型
    - 生成概念关系图(展示核心概念和它们之间的关系)
    - 生成流程图(展示处理步骤和工作流程)
    - 生成架构图(展示系统架构和组件关系)
    - 生成类图(展示类和对象的结构关系)
    - 生成状态图(展示状态转换和生命周期)
    - 根据语言配置生成对应的标签(中文/英文)

第五步:生成文章内容
    - 使用 Python 脚本生成文章内容
    - 按照"场景→痛点→解决→经验→思考"结构组织
    - 语言风格参考酷壳:自然不做作,有技术态度
    - 避免使用"首先/其次/最后/综上所述"等机械过渡词
    - 靠技术逻辑自然推进,适当使用"说到这个..."、"不过..."、"扯远了..."等口语衔接
    - 在设计方案有问题时加入适度吐槽(有建设性,不乱杠)
    - 加入真实踩坑经验和使用场景,不要泛泛而谈
    - 严格控制字数在配置范围内(800-4000字)
    - 在适当位置自动插入关系图
      * 概念图:在"痛点"后插入
      * 架构图:在"思考"后插入

第六步:保存为Markdown文件
    - 生成标准Markdown格式的文章文件
    - 文件命名格式:`<主题>_article_YYYYMMDD.md`
    - 保存位置:用户指定目录或当前目录
    - 文件头部包含标题、日期、标签、描述等元信息

第七步:输出完成信息
    - 返回生成文件的完整路径
    - 显示文章字数统计和配置信息
    - 列出搜索到的资料来源
    - 标注生成的关系图类型和数量
    - 提示用户可以根据需要进一步修改

[注意事项] - 主题明确性:如果用户需求描述不够具体,必须先询问确认,避免生成偏离用户期望的文章 - 技术准确性:所有技术细节必须基于搜索到的真实经验,不能凭空捏造或使用过时的信息 - 酷壳式风格:追求自然不做作的表达,避免八股文式的工整句子 - 去AI味:避免"首先/其次/最后/综上所述"等机械过渡词,让技术逻辑自然流动 - 真实踩坑:优先选择有具体问题、解决方案、实际经验的内容,不要泛泛而谈 - 适度吐槽:只在设计方案有问题时吐槽,不乱杠,有建设性 - 结尾方式:用个人感想 + 问题留给读者思考,代替"综上所述" - 长度控制:根据配置严格控制字数范围(concise: 800-1200, standard: 1500-2500, detailed: 2500-4000) - 文件路径:保存文件前必须确认目录存在且可写 - 搜索质量:至少搜索3-5个有真实场景的资料源,避免纯文档罗列 - 自然衔接:段落之间用技术逻辑自然衔接,不要依赖过渡词 - 多语言支持:支持中文和英文输出,根据用户需求选择合适的语言 - 配置验证:在生成前验证所有配置参数,确保输入的有效性 - 关系图生成:根据主题关键词自动选择最合适的图表类型(概念图/流程图/架构图/类图/状态图) - 关系图位置:概念图插入在"痛点"后,架构图插入在"思考"后 - 多语言关系图:关系图的标签会根据文章语言自动切换(中文/英文) - 引用说明:如果文章中引用了特定资料或数据,应在适当位置注明来源