每日技术实践简报 - 2026-03-29：从 MCP 到一键发包的博客深度写作与 Skill 链优化

推荐阅读

#

• 每日技术实践简报 - 2026-03-28
• 从 MCP 到一键发包：把 Teambition 评论里的 APK 自动上传 Nexus 的那些坑
• OpenClaw AI Agent 架构解析：多引擎联动与记忆系统

今日技术实践

#

解决的问题

#

• 深度博客文章撰写：完成"从 MCP 到一键发包"的 300+ 行技术博客，完整记录了从 Teambition MCP 对接到 APK 自动上传 Nexus 的全链路踩坑过程。
• Blowfish 主题 shortcode 踩坑：发现主题没有 notice shortcode，只有 alert。经过多次 sed/edit 替换尝试，最终确认正确语法为 {{< alert "icon-name" >}}内容{{< /alert >}}。
• Mermaid 流程图修复：从 text 代码块改为 {{< mermaid >}} shortcode 格式，Hugo 才能正确渲染可视化流程图。
• Git 分支治理：发现旧分支 feat/extract-markdown-rental-risk-20260324 堆积了大量无关提交（_index.md 修改、租房信息文章等），从 main 重新创建干净分支，只包含必要文件。

学到的新东西

#

• Blowfish 可用 shortcode 清单：alert、mermaid、chart、timeline、figure、gist、katex 等。写文章前先确认 shortcode 存在，不要凭记忆用。
• blog-post-generator Skill 规范：frontmatter 需要 featureimage、keywords、tags_weight/categories_weight；推荐阅读用相对路径内链；代码块必须是实际可用代码，不要伪代码。
• Git 分支清理策略：保护分支的仓库应"从 main 创建新分支 → cherry-pick 或 checkout 需要的文件 → 关闭旧 MR → 创建新 MR"，比 rebase 更可控。
• 租房等非技术内容不应推到技术博客：分支提交前必须 review 文件列表，排除无关内容。

实际产出

#

• 深度博客文章 1 篇（302 行，9892 字节）
• 3月28日日报 1 篇
• Git MR !53 创建（干净版本，排除租房信息）

踩坑记录

#

• notice shortcode 不存在：Blowfish 主题没有 notice，只有 alert。Skill 文档记录有误，需以实际 shortcode 目录为准。
• 多次 sed 替换导致文件状态混乱：部分 notice 被替换为 alert，但残留不完整标签。应一次性 read 全文确认再精确 edit。
• Hugo 版本兼容性警告：Module “blowfish” is not compatible with Hugo 0.137.0/0.148.0，但实际构建可通过，属于警告而非阻断。

其他思考

#

• 博客写作风格确立：口语化、有实操感、不要 AI 味；像一个资深工程师在写给同行看；段落简短，多用小标题。
• 博客 Skill 链（blowfish-hugo + blog-post-generator + structured-guide-writer）已形成完整工作流，后续写作效率会持续提升。