https://djchan.pages.dev/ Recent content on DJChan Hugo zh-cn Sat, 09 May 2026 23:13:13 +0800 https://djchan.pages.dev/blog/2026-05-09-%E7%A2%8E%E7%A2%8E%E5%BF%B5~/ Sat, 09 May 2026 23:13:13 +0800 https://djchan.pages.dev/blog/2026-05-09-%E7%A2%8E%E7%A2%8E%E5%BF%B5~/ <h2 id="vibe-coding-技巧">Vibe Coding 技巧</h2> <ul> <li>通过 Gemini/GPT 生成原型图参考，不断交流修正自己模糊的 idea</li> <li>让 AI 生成 SVG 格式的产品 Logo, 既能作为 favicon, 又能作为前端组件。</li> </ul> <p><img alt="Otter Music" loading="lazy" src="https://djchan.pages.dev/img/pixpin_2026-05-09_23-14-40.png" title="My First Vibe Music App"></p> https://djchan.pages.dev/blog/2026-05-09-claude-md/ Sat, 09 May 2026 23:12:49 +0800 https://djchan.pages.dev/blog/2026-05-09-claude-md/ <h1 id="claudemd">CLAUDE.md</h1> <h2 id="基础约定">基础约定</h2> <ul> <li>语言：中文</li> <li>环境：Windows / PowerShell</li> <li>风格：技术导向、简洁明了、优雅高效</li> <li>注释：必须有函数级注释</li> </ul> <h2 id="核心原则">核心原则</h2> <h3 id="1-先理解再编码">1. 先理解，再编码</h3> <ul> <li>修改前必须完整阅读相关代码。</li> <li>基于事实判断，禁止猜测。</li> <li>不确定时必须说明疑问并询问。</li> <li>存在多种理解时，先列出选项，不要静默选择。</li> <li>涉及 Breaking Change，必须先确认。</li> </ul> <h3 id="2-简单优先">2. 简单优先</h3> <ul> <li>采用最简单可行方案。</li> <li>只实现明确需求，禁止额外功能。</li> <li>禁止为单次使用代码设计抽象。</li> <li>禁止引入无必要的灵活性、配置项或复杂模式。</li> <li>优先使用成熟稳定库，避免重复造轮子。</li> <li>优先级：正确性 &gt; 可读性 &gt; 性能；仅在确认瓶颈后优化。</li> </ul> <h3 id="3-最小改动">3. 最小改动</h3> <ul> <li>只修改与需求直接相关的代码。</li> <li>不做无收益的重构、格式化或风格调整。</li> <li>不“顺手优化”相邻代码。</li> <li>保持现有代码风格，即使不是最理想风格。</li> <li>若发现无关问题，只说明，不擅自修改。</li> <li>仅删除因本次改动产生的无用 imports、变量、函数或代码。</li> </ul> <p>判断标准：每一行改动都应能直接对应用户需求。</p> <h3 id="4-可验证执行">4. 可验证执行</h3> <p>将任务转化为可验证目标：</p> <ul> <li>修 Bug：先复现问题，再修改并验证。</li> <li>加功能：明确输入、输出、边界条件与测试方式。</li> <li>重构：确保修改前后行为一致，并运行相关测试。</li> </ul> <p>多步骤任务需先给出简要计划：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>1. [步骤] → 验证：[检查方式] </span></span><span style="display:flex;"><span>2. [步骤] → 验证：[检查方式] </span></span><span style="display:flex;"><span>3. [步骤] → 验证：[检查方式] </span></span></code></pre></div><p>完成后必须说明：</p> <ul> <li>修改了什么</li> <li>为什么这样改</li> <li>如何验证</li> <li>是否存在风险或后续事项</li> </ul> <h2 id="5-cicd-规范">5. CI/CD 规范</h2> <ul> <li>AI 生成的提交信息必须添加 <code>🤖</code> 前缀。</li> <li>提交前必须确保最小 CI/CD 流程可通过，至少验证：构建成功、核心测试通过、基础运行正常</li> <li>项目必须包含最小可用 CI 配置：<code>.github/workflows/ci.yml</code></li> </ul> <h2 id="成功标准">成功标准</h2> <p>这些准则应带来：</p>