Thoughts

Skill 与 MCP 解决不同层次的复用问题，CLI 也没有因此过时。本文用代码审查场景解释三者的边界，以及何时应该抽取脚本、何时值得引入 MCP。

这篇文章只记录 Agent 工具调用的最小闭环：声明工具 schema、接收 function_call、执行本地函数，并通过 function_call_output 继续下一次模型决策。

Agent 做错判断时，不要先凭感觉升级模型或增加工作流。先冻结模型实际可见的输入，再用同输入可解性、信息增量和输出唯一性三项测试定位问题究竟在推理侧、系统侧还是任务契约。

一次 RAG 与知识图谱独立运行模式的架构讨论，让我重新分清了 Pipeline、Run、动态 Target 和跨请求 Singleflight。我的结论是：文档索引系统更适合让每次 Run 独立拥有状态和节点，同一文件只保留一个活动 Run，并通过持久化产物复用结果，而不是共享正在执行的节点任务。

代码领域之所以最早得到 AI 自动化，不只是因为代码适合大模型，而是因为软件工程已经拥有版本控制、测试、增量提交和回滚机制。其他领域并不是没有评价标准，而是缺少把标准绑定到中间版本上的工作流。文章、小说、视频、3D 模型等复杂作品也能被拆解、验证、冻结和追溯；而且文字领域天然拥有经典作品、评论和写作理论作为 reference corpus。一旦这些参照物被转成任务、rubric 和 checkpoint，AI 可能比在代码领域释放出更强的能力。

一次真实试用后，我把 MemPalace 和现有 docs / issue / commit 工作流逐项对比，结论是：它适合保存聊天中的长期上下文，但不适合充当正式 source of truth。

讨论在使用 AI 辅助编码时如何避免复制粘贴依赖，结合费曼技巧、刻意练习与检索练习，给出可操作的自检清单与演练步骤。

标题：用 Hugo + GitHub Pages 十分钟上线个人博客（超详细新手指南） 副标题 / 摘要 本教程带你从零开始，将本地 Hugo 博客部署到 GitHub Pages，全程只需 10 分钟，适合想快速上线技术博客、文档站点的开发者。确保你不仅能跑起来，还能理解背后的工作原理。 目标读者 Hugo 初学者 想快速上线个人技术博客的开发者 想了解 GitHub Pages + GitHub Actions 部署的用户 想要零成本托管静态网站的同学 背景 / 动机：为什么要用 Hugo + GitHub Pages？ 许多人写博客时面临这些痛点： 发布文章要手动上传，不自动化 静态站点生成器很多，但部署步骤零散 GitHub Pages 文档不够清晰，新手容易踩坑 主题（如 PaperMod）需要正确处理资源（SCSS）才能编译成功 Hugo + GitHub Pages + GitHub Actions 组合 完美解决了这些问题： Hugo 构建速度极快（上千文章依旧瞬间生成） GitHub Pages 完全免费，不需要服务器 GitHub Actions 自动部署，写完文章 push 即上线 核心概念（必须理解） 1. Hugo 一个超快的静态博客生成器，通过 Markdown 生成 HTML。 2. GitHub Pages GitHub 提供的免费静态网站托管。 ...

标题：如何使用 Hugo 发布文章：从 Markdown 到线上博客的全流程指南 副标题 / 摘要 这篇文章教你如何使用 Hugo 创建、管理与发布文章，包括 front matter 设置、草稿管理、图片处理、目录结构、预览与上线，让你从零掌握完整写作流程。 目标读者 Hugo 初学者 想用 Hugo 搭建技术博客的人 想学习 Markdown + 静态站点写作流程的开发者 使用 PaperMod、DoIt 等主题的用户 背景 / 动机 很多人在成功搭建 Hugo 博客后会遇到新的困惑： 文章应该放在哪个目录？ front matter 要怎么写？ 图片要放哪？ 为什么本地能看到文章但线上看不到？ 草稿 / 发布时间如何控制？ 怎样让文章自动出现在首页？ 这些都是 Hugo 新手非常常见的痛点。 本教程用实战步骤 + 最佳实践帮助你完全掌握“如何发布文章”的整个流程。 核心概念 1. Hugo Content（内容目录） Hugo 的文章都放在 content/ 目录下，比如： content/ posts/ my-first-post.md 2. Front Matter 文章头部的三段 YAML/TOML/JSON，用来控制文章： --- title: "文章标题" date: 2024-08-26 draft: false tags: ["hugo", "blog"] --- 3. Draft（草稿） 草稿不会被构建，只能在本地用 hugo server -D 查看。 ...

🧭 标题： 如何编写一份合格的 API 文档：从 Tony Tam 的 Swagger 到现代 OpenAPI 实践 ✍️ 副标题 / 摘要 想让你的 API 被开发者真正用得舒服？这篇文章将带你从理念到实践，全面掌握一份高质量 API 文档的结构、示例与最佳规范，基于 Tony Tam 提出的 Swagger / OpenAPI 标准。 🎯 目标读者 初学者：想了解 API 文档标准结构的人。 中级开发者：希望提升接口文档可维护性与规范性的人。 架构师 / 技术负责人：负责 API 设计规范制定与团队协作的人。 💡 背景 / 动机 许多开发团队的 API 文档存在以下痛点： 信息零散，缺乏统一格式； 更新滞后，开发与文档脱节； 无法直接用于自动生成或测试。 Tony Tam 于 2010 年提出的 Swagger 规范（后更名为 OpenAPI） 正是为了解决这些问题。如今，它已成为 RESTful API 文档的事实标准，被 Google、Amazon、Stripe 等公司广泛采用。 🔍 核心概念 概念 说明 API 文档 描述应用程序接口如何被调用、请求与响应的技术说明书。 Swagger / OpenAPI 一种用于定义、生成、测试 REST API 的标准化规范。 Endpoint（端点） API 中可访问的具体路径（如 /users/{id}）。 Schema（数据模型） 定义请求与响应的字段结构。 🧰 实践指南 / 步骤 明确文档结构 概述（Overview） 鉴权机制（Authentication） 接口定义（Endpoints） 数据模型（Schemas） 错误码与示例（Errors & Examples） 使用 OpenAPI 规范组织文档 建议采用 YAML 格式，支持机器可读与可视化。 推荐工具链 编辑器：Swagger Editor、Stoplight Studio、VS Code + YAML 插件 文档展示：Swagger UI / ReDoc 自动生成：通过注释生成（如 Springdoc、FastAPI、NestJS） ...