https://wlj.me/tags/docs/Recent content in Docs on Luca's BlogHugozhSun, 10 May 2026 22:35:00 +0800https://wlj.me/posts/google-code-wiki/Sun, 10 May 2026 22:35:00 +0800https://wlj.me/posts/google-code-wiki/<p>Google 在 2025 年 11 月推出了 <a href="https://codewiki.google">Code Wiki</a>，对着任意 GitHub 公开仓库自动生成持续同步的可交互文档站——架构图、类图、时序图，加一个用这份 wiki 当上下文的 Gemini chat。</p> <p>用法：把 <code>github.com/&lt;org&gt;/&lt;repo&gt;</code> 换成 <code>codewiki.google/github.com/&lt;org&gt;/&lt;repo&gt;</code>。</p> <p>丢一个看效果：<a href="https://codewiki.google/github.com/openclaw/openclaw">openclaw/openclaw 的 Code Wiki 视图</a>。</p> <p>私有仓库要走 Gemini CLI extension。</p> <p>官方介绍：<a href="https://developers.googleblog.com/introducing-code-wiki-accelerating-your-code-understanding/">Introducing Code Wiki</a>。</p>https://wlj.me/posts/warp-docs-agent-workflow/Sun, 10 May 2026 21:05:01 +0800https://wlj.me/posts/warp-docs-agent-workflow/<p>Warp 是从终端起家的 AI 开发环境。2026 年 5 月，它把产品文档站 docs.warp.dev 的源代码开源了，仓库地址 <a href="https://github.com/warpdotdev/docs">github.com/warpdotdev/docs</a>。这个仓库除了文档内容本身，还配了一整套用 AI agent 维护文档的工作流。</p> <p>文档站基于 Astro 6 + Starlight，内容用 MDX 写在 <code>src/content/docs/</code> 下。Node.js 22 起步，<code>npm install</code> 后 <code>npm run dev</code> 启动本地预览，端口 4321。&ldquo;Ask AI&rdquo; 按钮和 &ldquo;Was this helpful?&rdquo; 反馈是可选功能，需要在 <code>.env</code> 里填公开值。</p> <p>下面分四块说明仓库里 agent 相关的结构。</p> <h2 id="agents-目录"><code>.agents/</code> 目录</h2> <p><a href="https://github.com/warpdotdev/docs/tree/main/.agents">.agents/</a> 分四个子目录：</p> <ul> <li><strong><code>skills/</code></strong> — <a href="https://github.com/warpdotdev/docs/tree/main/.agents/skills">25 个 skill</a>。每个 skill 是一个子目录，里面至少有一个 <code>SKILL.md</code> 描述用途和执行步骤，部分含有 <code>references/</code>、<code>scripts/</code>。</li> <li><strong><code>rules/</code></strong> — 通用规则，当前只有一个 <a href="https://github.com/warpdotdev/docs/blob/main/.agents/rules/oz-style-guidelines.md"><code>oz-style-guidelines.md</code></a>。</li> <li><strong><code>templates/</code></strong> — 不同类型文档页面的模板（quickstart、guide、procedural 等）。</li> <li><strong><code>references/</code></strong> — 词汇表等参考资料。</li> </ul> <p>25 个 skill 按用途分四类：</p> <p><strong>草稿生成（10 个）</strong>：<code>draft_quickstart</code>、<code>draft_guide</code>、<code>draft_procedural</code>、<code>draft_conceptual</code>、<code>draft_reference</code>、<code>draft_faq</code>、<code>draft_troubleshooting</code>、<code>draft_feature_doc</code>、<code>draft_docs</code>、<code>missing_docs</code>。从空白页起一篇新文档时使用。</p>