设计理念
<div class="prose max-w-none space-y-8">
<section>
<h2>两层知识架构</h2>
<p>
本站的架构根植于一个核心洞察:<strong>通用知识统一管理,项目专属知识跟随项目</strong>。
</p>
<p>
第一层(全局知识)存在于 <code>~/.claude/CLAUDE.md</code>,定义跨项目共享的工作规范、Git 流程、编码标准。
第二层(项目知识)在各项目根目录的 <code>CLAUDE.md</code>,只写该项目独特的技术栈和经验。
</p>
<p>
这种架构通过引用机制避免重复,实现配置的最大复用。规则系统(Rules)记录行为准则,
Skill 系统封装场景化的最佳实践,Memory 系统持久化上下文和决策。
</p>
</section>
<section>
<h2>隐私边界设计</h2>
<p>
公开内容与隐私内容严格分离。网站源码(<code>fuhuo_20260419</code>)只包含:
</p>
<ul>
<li>工作流介绍、博客文章、文档</li>
<li>规则原文(Rules)——行为准则不含密钥</li>
<li>工具脚本(smart-autopush 等)</li>
<li>命令定义(67 个 Skill 命令)</li>
<li>PLAN 模板(七层提示词栈)</li>
</ul>
<p>
隐私内容(<code>memory/</code>、<code>knowledge/</code>、<code>rules/</code> 中的敏感变体)留在 <code>~/.claude</code> 本地,不进入代码仓库。
</p>
</section>
<section>
<h2>声明式优先于命令式</h2>
<p>
规则采用声明式描述<em>期望的结果</em>,而非命令式描述<em>执行的步骤</em>。
这给 AI Agent 更多自主权去探索解决方案,而非机械地执行预设指令。
</p>
<p>
例如:DoD(Definition of Done)描述"当传入无效输入时函数必须返回错误",
而非"写一个验证函数检查输入"。前者允许模型自主探索最佳实现方式。
</p>
</section>
<section>
<h2>证据驱动验证</h2>
<p>
每个声明必须有实际证据支撑。技术层验证(build 通过)不等于症状消失,
需要补充症状级证据。工具链:Playwright 截图、<code>curl</code> 响应内容、<code>fc-list</code> 字体验证。
</p>
</section>
<section>
<h2>自我进化机制</h2>
<p>
从失败中学习并固化为可复用规则。每次 Debug/Troubleshooting 完成触发 Case 归档,
失败模式命名(Named Failure Modes)建立自我监测触发器,防止同类错误重复出现。
</p>
</section>
<section>
<h2>技术选型</h2>
<ul>
<li><strong>Astro v6</strong> — 静态站点生成,性能优先</li>
<li><strong>Tailwind v4</strong> — CSS 变量驱动的主题系统,无配置文件负担</li>
<li><strong>GitHub Actions</strong> — CI/CD,每次 push 自动构建部署</li>
<li><strong>私有仓库 + GitHub Pages</strong> — 教育账号 Pro 权益,隐私与托管兼顾</li>
</ul>
</section>
</div>