{"slug":"pdlc-perf","title":"pdlc-perf","summary":"性能优化","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-09-23T18:54:24.717956Z","repo":{"url":"https://github.com/kanfu-panda/pdlc-skills","stars":15,"forks":2,"license":"MIT","updatedAt":"2026-09-23T15:59:31Z"},"bodyHtml":"<hr>\n<p>name: pdlc-perf\ndescription: 性能优化\nargument-hint: &lt;功能ID | 优化目标&gt;\nallowed-tools: Read, Write, Edit, Glob, Grep, Bash\nlayer: 3\nstage: quality\nproduces:</p>\n<ul>\n<li>docs/04_testing/perf/</li>\n</ul>\n<hr>\n<h1>性能优化</h1>\n\n<p>⛔ <strong>IRON LAW · 不可违反的硬门禁</strong></p>\n<p>以下规则为<strong>不可协商</strong>的执行约束：</p>\n<ol>\n<li><strong>文件必须落盘</strong>：所有带编号（功能ID / 缺陷ID）的文档，必须作为实际文件写入磁盘，不可仅在对话中输出。</li>\n<li><strong>阶段必须落章</strong>：每个阶段完成后必须在状态机 <code>docs/.pdlc-state/&lt;feature-id&gt;.json</code> 追加 history，不可跳过。</li>\n<li><strong>测试必须存在</strong>：进入 <code>/pdlc-implement</code> 前，对应测试必须存在且处于红灯状态。违反则中止。</li>\n<li><strong>自检必须执行</strong>：段二自检为强制步骤，不得以\"已经很好了\"为由跳过。</li>\n<li><strong>防循环</strong>：段三修复为单次，不递归。无法自动修复的问题记录到报告，继续往下走。</li>\n<li><strong>状态必推进</strong>：成功执行某 phase 后 <code>current_stage</code> 必须变更。收尾时若发现 <code>current_stage</code> 未推进，视为失败并报错，<strong>不得静默返回</strong>（防止外层循环拿滞后的状态空转烧额度）。唯一例外：命中人工点主动 block 时，<code>current_stage</code> 保持不变但必须写 <code>last_phase_result.ok=false</code> + <code>blocked_reason</code>。</li>\n</ol>\n<p><strong>违反任一条 = 立即中止当前命令，输出违规详情，等待人工介入。</strong></p>\n\n<p>对指定服务或应用进行性能分析并提出优化方案。</p>\n<h2>分析维度</h2>\n<h3>后端性能</h3>\n<ul>\n<li><strong>数据库层</strong>: 慢查询、N+1 问题、缺失索引、全表扫描</li>\n<li><strong>缓存层</strong>: 缓存命中率、缓存策略（过期/淘汰）、缓存穿透/击穿/雪崩</li>\n<li><strong>接口层</strong>: 响应时间、并发处理、连接池配置</li>\n<li><strong>代码层</strong>: 算法复杂度、内存泄漏、不必要的序列化/反序列化</li>\n</ul>\n<h3>前端性能</h3>\n<ul>\n<li><strong>加载性能</strong>: 首屏时间、资源体积、代码分割、懒加载</li>\n<li><strong>运行时性能</strong>: 不必要的重渲染、大列表虚拟滚动、防抖/节流</li>\n<li><strong>网络优化</strong>: 请求合并、资源压缩、CDN 配置</li>\n<li><strong>缓存策略</strong>: 浏览器缓存、Service Worker、本地存储</li>\n</ul>\n<h2>工作流程</h2>\n<ol>\n<li><strong>阅读代码</strong>: 分析目标服务/应用的核心逻辑</li>\n<li><strong>识别瓶颈</strong>: 标注可能存在性能问题的代码段</li>\n<li><strong>提出方案</strong>: 对每个问题给出优化方案和预期收益</li>\n<li><strong>实施优化</strong>: 按优先级实施优化代码</li>\n<li><strong>【必须创建文件】</strong> 在 <code>docs/07_reviews/code/</code> 下创建性能优化报告</li>\n</ol>\n<blockquote>\n<p>⚠️ <strong>必须创建文件，不可仅在对话中输出。</strong></p>\n</blockquote>\n<h2>报告格式</h2>\n<p>文件名: <code>YYYYMMDD-&lt;服务名&gt;-perf-report.md</code></p>\n<p><strong>文档顶部包含 PDLC 追溯头</strong>：</p>\n<pre><code>&lt;!-- PDLC-TRACE --&gt;\n&lt;!-- 功能名称: &lt;服务名&gt; --&gt;\n&lt;!-- 阶段: 性能优化 --&gt;\n&lt;!-- 创建时间: &lt;ISO 8601&gt; --&gt;\n</code></pre>\n<p><strong>报告内容</strong>：</p>\n<table>\n<thead>\n<tr>\n<th>序号</th>\n<th>位置</th>\n<th>问题描述</th>\n<th>影响程度</th>\n<th>优化方案</th>\n<th>预期收益</th>\n</tr>\n</thead>\n</table>\n<p><strong>创建后验证</strong>：确认文件已存在于 <code>docs/07_reviews/code/</code> 目录</p>\n<h2>要求</h2>\n\n<p>\uD83C\uDF10 <strong>Output language for generated artifacts</strong></p>\n<p>All generated artifacts (PRDs, design docs, code comments, review reports,\ntest plans, deployment manuals, changelog entries, etc.) follow this policy:</p>\n<ol>\n<li><p><strong>Default — match the conversation language exactly</strong>:</p>\n<ul>\n<li>用户用中文与 Claude 对话 → 产中文文档、中文代码注释、中文报告</li>\n<li>User talks to Claude in English → produce English artifacts</li>\n<li>User talks in another language → produce artifacts in that language</li>\n<li><strong>Never silently default to a fixed language regardless of the user's input.</strong></li>\n</ul>\n</li>\n<li><p><strong>Explicit override always wins</strong>: when the user specifies a language for\nan artifact (e.g. \"write the PRD in English\", \"用英文写 API 设计文档\",\n\"output the deploy doc in Japanese\"), use that language for that artifact,\nregardless of conversation language.</p>\n</li>\n<li><p><strong>Mixed-language requirements</strong>: if the user wants some artifacts in one\nlanguage and others in a different language (common: Chinese PRD + English\nAPI docs for partners), honour each per-artifact instruction.</p>\n</li>\n<li><p><strong>Uncertain</strong>: if you cannot reliably detect the conversation language,\nask once before producing the first artifact.</p>\n</li>\n</ol>\n<p>This policy applies to <strong>content</strong> (prose, comments, headings). It does\n<strong>not</strong> override technical conventions like English variable names, English\ngit commit subjects, or English error codes when the project's conventions\nrequire them.</p>\n\n<ul>\n<li>优化方案按投入产出比排序（性价比高的优先）</li>\n<li>给出优化前后的代码对比</li>\n<li>不要为了优化而牺牲代码可读性</li>\n</ul>\n<p>优化目标: $ARGUMENTS</p>\n\n<h2>段四：交接（Handoff）</h2>\n<p>命令完成后必须输出以下格式的最终消息：</p>\n<pre><code>✅ &lt;阶段名&gt; 完成：&lt;主要产出物路径&gt;\n\uD83D\uDCCA 自检：&lt;通过数&gt;/&lt;总数&gt; 通过（若有未通过，附要点）\n\uD83D\uDCE6 状态快照：docs/.pdlc-state/&lt;feature-id&gt;.json\n\uD83D\uDC49 下一步：/pdlc-&lt;next_step&gt;\n   （如果有分叉）或 /pdlc-&lt;alt&gt;（条件：&lt;选择依据&gt;）\n</code></pre>\n<p><strong>规则：</strong></p>\n<ul>\n<li>主流程命令（写状态机的命令；下一跳见正文里「本命令的状态机取值」）必须显式输出\"下一步\"，不可省略</li>\n<li>工具型命令（Layer 3）可以没有 <code>next_step</code>，此时输出 <code>\uD83D\uDC49 下一步：（本次流程结束，无后续）</code></li>\n<li>分叉场景必须说明<strong>选择条件</strong>，例如\"若需补充测试用例 → <code>/pdlc-tdd</code>；若测试已齐 → <code>/pdlc-review</code>\"</li>\n</ul>\n\n<p><strong>本命令的 handoff 输出：</strong></p>\n<pre><code>✅ 性能优化报告 完成\n\uD83D\uDCE6 产出：docs/04_testing/perf/&lt;feature-id&gt;-report.md\n\uD83D\uDC49 下一步：（本次流程结束，无后续）\n</code></pre>\n","files":[{"path":"SKILL.md","sizeBytes":6159,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-23T18:54:55.725361Z","sha256":"6944FBCF18E75FBC202A47115E0D0A2B6C48161F4E3EB6F5F772F5D4FA80D0CB","sizeBytes":3579},"review":null,"source":{"repositoryUrl":"https://github.com/kanfu-panda/pdlc-skills","path":"skills/pdlc-perf","license":"MIT","commit":"3cd2f02ab45cb1cd48962e0f298ae4dad9fb442f","subtreeSha":"39BAFA0BB190CBA0094156362B446E1678CF5360A41D5EB07C13F54DE015C196","lastSyncedAt":"2026-09-23T18:54:21.123477Z"},"reviewedAt":"2026-09-23T18:56:09.93028Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/kanfu-panda/pdlc-skills/tree/main/skills/pdlc-perf"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install kanfu-panda-pdlc-skills@llmmart"},{"target":"git","command":"git clone https://github.com/kanfu-panda/pdlc-skills.git"}]}