{"slug":"pdlc-onboard","title":"pdlc-onboard","summary":"新人引导 / 自动化生成用户手册","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-09-23T18:54:24.575032Z","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-onboard\ndescription: 新人引导 / 自动化生成用户手册\nargument-hint: [项目目录 | 模块]\nallowed-tools: Read, Write, Edit, Glob, Grep, Bash\nlayer: 3\nstage: lifecycle\nproduces:</p>\n<ul>\n<li>docs/ONBOARDING.md\nrequires: []\nnext_step: null\nterminal_state: null</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<ol>\n<li>扫描整个项目结构，了解当前状态</li>\n<li>运行 <code>make status</code> 查看服务和应用列表</li>\n<li>阅读 <code>CLAUDE.md</code>、<code>README.md</code> 获取项目概述</li>\n<li>汇总输出新人引导信息</li>\n</ol>\n<h2>输出内容</h2>\n<h3>1. 项目总览</h3>\n<ul>\n<li>项目名称和用途</li>\n<li>技术栈概述</li>\n<li>微服务列表及各自职责</li>\n<li>前端应用列表及各自职责</li>\n</ul>\n<h3>2. 环境搭建</h3>\n<ul>\n<li>必要的开发工具和版本要求</li>\n<li>本地开发环境搭建步骤</li>\n<li>配置文件说明</li>\n</ul>\n<h3>3. 开发规范</h3>\n<ul>\n<li>引用 <code>docs/00_standards/coding-standards.md</code>（未命中 → 提示 <code>consider /pdlc-standard add coding/&lt;topic&gt;</code>）</li>\n<li>Git 分支策略和提交规范</li>\n<li>PDLC 工作流说明</li>\n</ul>\n<h3>4. 快速上手</h3>\n<ul>\n<li>如何运行项目</li>\n<li>如何运行测试</li>\n<li>如何创建新功能（指向 <code>/new-feature</code> 命令）</li>\n<li>常用 Make 命令一览</li>\n</ul>\n<h3>5. 关键文档索引</h3>\n<ul>\n<li>列出 <code>docs/</code> 下所有重要文档的路径和摘要</li>\n</ul>\n<h3>6. 常见问题</h3>\n<ul>\n<li>构建失败怎么办</li>\n<li>测试报错怎么排查</li>\n<li>如何联调</li>\n</ul>\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>输出到 <code>docs/03_development/onboard-guide.md</code></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/ONBOARDING.md\n\uD83D\uDC49 下一步：（本次流程结束，无后续）\n</code></pre>\n","files":[{"path":"SKILL.md","sizeBytes":5548,"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.208663Z","sha256":"FC944C689AF887F5973BD82E8E45EFDBE4E75ACD5B723547B16397DDD928B089","sizeBytes":3321},"review":null,"source":{"repositoryUrl":"https://github.com/kanfu-panda/pdlc-skills","path":"skills/pdlc-onboard","license":"MIT","commit":"3cd2f02ab45cb1cd48962e0f298ae4dad9fb442f","subtreeSha":"86B68EA4537E68533D18E91404D499C1F880C85D29A481678C2A2662A38BFAA0","lastSyncedAt":"2026-09-23T18:54:21.123477Z"},"reviewedAt":"2026-09-23T18:55:50.366491Z","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-onboard"},{"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"}]}