dev-skills
通用开发工作流技能:需求开发全流程、bug 修复、代码优化、重构(结构改造)、提交改动与代码评审、合并请求(MR/PR)生成、单元测试、注释补齐、前端报错诊断、文档与代码同步、项目讲解、仓库指引初始化、日志诊断、数据库查询、多模块并行改造、opencode 并行改造编排、NAS 硬盘诊断、Git 分支清理 / 回滚 / worktree 管理、业务操作前置校验规则提取、国际化改造、打包与分发、开发规范路由、技能路由判断、任务指挥与编排
Plugin dev-skills from marketplace lldwb-claude-skills in lldwb/lldwb-claude-skills. Commands read from the repo's manifest — 1 month ago.
What it installs
Skills (29)
app-packaging打包与分发标准工作流——把应用做成「使用者拿到就能用」的产物并交付:产物形态决策(裸目录 / zip / 单文件可执行 / 安装包)、运行时依赖盘点、跨平台构建的边界与编排(什么能交叉、什么必须对应平台)、CI 构建与制品 / Release 附件分发、版本注入与校验和。当用户要求"把脚本打成 exe""做成不装依赖就能跑的单文件""多平台打包""加 CI 自动构建产物""把产物发到 Release 附件""怎么做校验和 / 发给别人怎么给"时使用——先定产物形态与平台矩阵,再打通单平台本地构建,再上多平台编排与分发,最后在干净环境实测产物。边界:构建 / 打包报错的缺陷定位用 bug-fix
bug-fixBug 修复的标准工作流。当用户要求修复 bug(现象描述、报错信息、trace_id、复现步骤、涉及模块/页面等)时使用——先理解再动手,按"问题现象 → 原因分析 → 修改方案 → 涉及文件"四段式组织,修改后必须编译/测试验证,最后按仓库规范提交 git。即使未明确说"用 skill",只要涉及 bug 定位与修复就应使用。改动仅落在注释层面(补全 / 修正注释描述)时用 comment-supplement;只需定位前端报错、不改代码时用 frontend-error-diagnose;对外行为不变的结构性改造用 refactor。
check-rule-extract业务操作前置校验规则提取(编排调度)——以菜单为入口(范围参数支持菜单完整路径或菜单名称,无菜单体系的项目可直接按 Controller 类名),经菜单权限明细数据源定位「菜单地址 → Controller」,调度子代理逐 Controller 追溯 Service/Validator 校验逻辑,合并生成业务管控逻辑 Excel 工作簿(.xlsx,通用列格式,项目可传 --template 覆盖为既有表格样式)。当用户要求"提取/梳理各接口操作前校验规则""生成管控逻辑收集表/操作前检查表""梳理某菜单下保存/删除/锁定/解锁前置校验"时使用——本 skill 仅做编排调度、不直接追溯代码;
code-optimize代码优化(小范围)的标准工作流:先理解再动手,按模块规划并实施优化(保持对外行为不变),编译/测试验证后按规范提交 git。当用户要求优化代码(重复代码抽取、局部性能提升、可读性提升、命名与局部结构改进等),或说"优化这段代码""清理小范围代码"时使用——只做小范围优化,改动保持对外行为不变;不属于本次优化的真实缺陷单列报告转 bug-fix,不夹带修复。即使未明确说"用 skill",只要涉及小范围代码优化/清理就应使用。结构性改造、分层/职责重构、实现迁移、批量同构改造(需要重构契约、测试基线与对抗性审查)用 refactor;新增或改变对外行为用 feature-dev;缺陷修复用 bu
code-review代码评审(多对象)——按评审对象分五种模式:提交评审(指定修订号)、合并评审(分支区间 / merge 提交)、模块评审(指定模块/目录)、项目整体评审(全仓横切面)、架构评审(分层与依赖结构),只检查不改代码。当用户要求"评审某个提交/PR 的质量""检查提交是否符合规范""排查某次提交引入的问题""这次提交有没有问题""这个 MR 能不能合""评审这个模块的代码质量""看看项目整体质量/健康度""评估一下项目架构/分层与依赖设计"时使用——先识别评审对象与模式再取数,不局限于 diff 或表面结构,深入阅读涉及的函数、模块与调用链;每条判断必须指回具体证据(diff 行 / 代码位置 /
comment-supplement注释补齐与修正的标准工作流。当用户要求"补全缺失的类/方法/字段注释""修正注释中不准确、过期或与代码实际行为不符的描述"时使用——改动严格限定在注释层面,不修改任何业务逻辑或影响程序运行,签名、注解、默认值与枚举取值等公开契约一律不动;无法从代码判断真实意图的整理成清单先交用户确认,不擅自推断。即使未明确说"用 skill",只要涉及注释补全/修正就应使用。注释问题与逻辑、结构、接口改动并存时用 bug-fix 一并处理;对外行为不变的结构性改造用 refactor。
commit-create提交工作区改动到本地 git 的标准工作流(commit 专员),也是提交环节的唯一实现(SSOT 源)。当用户要求"把当前工作区已修改的文件提交到本地仓库""按模块拆分提交""阅读改动帮我写中文 commit 信息并提交""提交时带 emoji""把这次改动补进上一次提交"时使用——先审查 git status 与 diff,按单一职责拆分提交,显式 git add 指定文件(禁止 -A / .),中文提交信息遵循项目规范,可选 emoji 前缀、显式指定 type/scope、仅用 Git 的轻量路径与 --amend(限未推送分支);不自动 push / merge / 建 PR。即使未
db-query数据库查询技能(psycopg2,PostgreSQL 协议,可连 GaussDB 等 PG 兼容库,多环境)。当需要查业务数据、核对数据状态、定位数据问题、验证修复前后数据时使用。生产环境只读(脚本拦截 + 会话只读 + 账号只读三重保障),测试环境可读写但写操作必须先获得用户确认并 --allow-write。执行脚本为 <skill 目录>/scripts/db-query.py,配置 db-query.config.json(gitignored,含账号密码,按 references/config.example.json 模板创建)。即使未明确说"用 skill",只要涉及查库就应使
doc-sync文档与代码同步的标准工作流(更新 / 修正两类):先由文档定位代码确认真实行为,只改与本次变更相关的部分,改完用子代理复核一致性。当用户给出文档或范围要求"阅读文档找到对应代码、确认变更后同步更新文档""确保文档与代码实际行为一致",或要求"修正文档中错误、过期、与代码实际行为不符的描述"时使用——文档内容必须与代码实际行为一致(不写未实现的功能、不做规划式描述,冲突时以代码为准);只更新与本次变更相关的文档,不擅自扩大范围、不顺手重排无关段落;复核由只读子代理执行、主代理核对证据后再采纳,无法从代码判断的意图整理成待确认清单交用户。即使未明确说"用 skill",只要涉及文档与代码对齐就应使
feature-dev需求开发全流程工作流(需求分析 → 方案设计 → 规划文档 → 实现子代理 → 测试子代理 → 对抗性审查 → 提交,实现 / 验证 / 审查固定编排)。当用户提出新需求、新功能、新接口、新链路,或要求对既有链路做较大改造(跨前后端、涉及外部依赖与第三方组件),并要求"从需求分析做到落地""把方案总结出来再执行""先出方案再改""按步骤实现并验证"时使用——先理解再动手(通读参考实现与相关代码、用证据核实外部依赖的真实能力),出方案并把关键决策点交用户确认,需要时把规划写成文档,实现、验证、对抗性审查三环节固定派专职子代理(改造与验证分离、改造与审查分离),最后按规范提交 git。即使未明确说
frontend-error-diagnose前端报错诊断的标准工作流:先用浏览器 MCP 复现报错,采集 console 报错、失败请求与 JS 调用栈等证据,定位根因后给出可执行的修复方案。当用户给出前端报错(APM/监控平台上报的 JS 报错、浏览器控制台报错、页面白屏、接口 4xx/5xx、CORS、资源加载失败等)并要求"分析是什么问题导致的报错""先复现再分析""给出解决方案"时使用——不凭报错文案猜结论、先复现再定位;默认只诊断不改代码;无法复现时按三档降级并说明档位,不静默跳过。即使未明确说"用 skill",只要涉及前端报错定位就应使用。需要直接改代码修复用 bug-fix;报错指向后端、需拉日志定位根因用 log-di
git-clean-branches安全清理 Git 分支:以指定基准找出已合并分支、按天数找出过期分支,默认只读预览、用户确认后才删除,支持保护分支清单与远程分支清理。当用户要求"清理已合并分支""删掉长期没动的分支""仓库分支太多整理一下""清理已合并到 main/release 的分支"时使用——默认 dry-run 只列清单、删除前需确认,受保护分支(git config branch.cleanup.protected)一律不删,未合并分支默认不删(--force 仅在用户显式要求并逐条确认后使用)。边界:只做分支清理,不删 tag、不改写历史(回滚历史用 git-rollback)、不动 worktree(用 git
git-history-rewriteGit 历史改写(结构性修正既有提交)标准工作流——拆分提交(一次提交按文件拆成多个)、改类型/标题、重排提交顺序、删除提交、恢复提交时间,含备份分支、方案先行、四重验证与强推。当用户要求"把某次提交拆成两个""把版本号/CHANGELOG 从功能提交里拆出去""统一历史提交的类型或标题""把发版提交移到版本最后""删除历史条目里的补记""恢复历史重写后的提交时间""整理历史提交结构"时使用——先备份、先出方案、改完四重验证、强推前确认。边界:把分支回滚到历史版本用 git-rollback;清理分支用 git-clean-branches;提交工作区改动用 commit-create;只做代
git-rollback交互式把 Git 分支回滚到历史版本:列分支 → 列版本 → 选 reset 或 revert → 二次确认后执行。当用户要求"把分支回滚到某个提交/tag""撤销一批提交""恢复到上一个版本""生成反向提交撤销误推"时使用——默认只读预览(dry-run);reset 改写历史需用户明确确认、执行前先建备份分支,受保护分支额外确认,不提供 --force、不自动强推也不自动 push。边界:历史与对象清理(reflog expire / gc --prune=now / filter-repo)默认不做;清理分支用 git-clean-branches;提交改动用 commit-create
git-worktree管理 Git worktree:在项目平级的统一目录下创建(自带智能默认分支名与基础分支)、列出状态、删除与清理无效引用,并支持在 worktree 之间迁移未提交改动或 stash、自动复制被 gitignore 的环境文件、按项目实际 IDE 命令打开、把 worktree 分支合回当前分支。当用户要求"开一个 worktree""在独立目录里做这个需求""并行开发两个分支互不干扰""把当前未提交的改动挪到另一个 worktree""清理失效的 worktree 记录""把 worktree 的改动合回当前分支"时使用。边界:多模块并行改造的编排(worktree + 子代理 + 合并)用
i18n-transform国际化(多语言)改造的标准工作流——把硬编码文案改造为资源文件驱动,覆盖后端消息 / 前端文案 / 参数校验消息三条改造线。当用户要求"把某模块做国际化 / 多语言改造""硬编码文案抽到资源文件""补齐多语言资源文件""参数校验消息做国际化"时使用——协调方只编排不写代码:扫描与单元划分 → 逐单元派改造子代理 → 独立只读审查子代理(🔴致命 / 🟡警告分级)→ 独立验证子代理(Key 集合一致、编码、映射完整)→ 汇总报告;改造与审查分离,重试 ≤ 2 轮后转"需人工介入"清单,不静默放行。只改文案与资源文件、零业务逻辑修改,改造中暴露业务缺陷转 `bug-fix`。即使未明确说"用 s
log-diagnose日志自动诊断 — 按 trace_id(或 --kw 关键词/业务单号)+ 时间窗从 Kibana(多环境,--env 切换)拉取日志,定位错误根因;需要核对业务数据状态时用 db-query skill 查库佐证(生产只读);判定为 BUG(含查询超时引发报错)时产出修复任务 MD 与独立事故报告 MD 两份文档。当用户给出 trace_id / 日志片段 / 业务单号(单据号、订单号等)要求排查线上问题、定位错误根因、判断是否 bug 时使用,即使未明确说"用 skill"。边界:需要改代码修复诊断出的缺陷用 `bug-fix`;需要核对业务数据状态用 `db-query`(生产只读);需
module-batch多模块并行改造/批量任务 — 为每个待处理模块创建一个独立 git worktree,各起一个子代理在 worktree 内直接完成该模块的改造任务(修改代码、执行测试、按容错条款处理失败、按门禁验收后提交),全部完成后合并回主分支并按规范提交。当用户要求"按模块批量改造/处理多个模块""多模块并行执行任务""按工作树隔离并行开发"时使用——任务说明必须写清测试命令与阶段门禁;单元隔离(一个模块 = 一个 worktree = 一个子代理);调度与执行分离、改造与审查分离;失败不静默(重试 ≤ 2 次,仍失败记"需人工介入"并继续其他单元)。即使未明确说"用 skill",只要涉及多模块批量/
mr-create生成合并请求(MR/PR)的标准工作流。当用户要求"生成合并请求""把当前分支提个 MR / PR""按指定源分支和目标分支建 MR 并自动写描述""这条分支帮我提 PR"时使用——先解析并校验源/目标分支(存在性、同一提交、有效差异,防空合并请求),再综合用户补充说明与该分支相对目标分支的提交记录自动生成四段式描述,用户确认后经 gh / glab 创建(无 CLI 时先走 git credential 令牌 + 平台 API 直建,不通再退输出描述与手工创建链接,并可按需推送源分支)。即使未明确说"用 skill",只要涉及提 MR / PR、生成合并请求描述、把已提交的分支送审就应使用。
nas-disk-diagnosticNAS 硬盘故障诊断与可视化报告:SSH 远程连接 Synology 等 NAS,按「基础状态采集 → SMART 深度诊断 → 坏盘可修复性评估 → 可视化报告 → 分级建议」流程排查,含扩展卡硬盘必须用 smartctl -d sat 等关键知识点。当用户要求"查 NAS 硬盘""排查坏盘""看 SMART""硬盘诊断""RAID 降级排查""存储空间不够看看盘"时使用——只做只读采集与诊断(rescan 除外,需用户确认),结论必须由 SMART 原始值支撑;诊断脚本只取数不下结论。边界:非 NAS 场景的磁盘/文件系统问题按通用系统排障处理;需要改动 RAID 配置(re-add /
opencode-batch多模块并行改造任务编排(opencode CLI 版)——为每个待改造模块建一个独立 git worktree、各起一个子代理在 worktree 内调用 opencode CLI 执行该模块对应的 opencode 命令,全部完成后合并回主分支并提交。当用户要求"用 opencode 批量改造多个模块""每个模块一个 worktree 跑 opencode""并行跑多个 opencode 命令"时使用——由用户提供三要素(主分支 / opencode 命令 / 待改造模块),开始前做前置检查(opencode CLI 可用、.opencode 已入库、测试凭据明文、外部依赖连通、模块路径存在
project-explain结合具体项目讲解概念的工作流。当用户说"我不懂如下内容,给我讲清楚""结合这个项目讲讲 X""这块是怎么实现的,讲一下"时使用——先读项目代码与文档,再逐项结合本项目实际讲解并引用真实文件与代码位置(不泛泛而谈);输出 Markdown(开头一个一级标题、正文分点组织、结尾一小节说明"这是什么项目");不臆造,代码里找不到依据的内容不写、查不到就明确说明。即使未明确说"用 skill",只要涉及讲清项目中的概念或实现就应使用。边界:要把讲解沉淀为项目文档用 `doc-sync`;要改代码(缺陷修复 / 优化 / 新增功能)用 `bug-fix`、`code-optimize`、`feature
refactor重构(结构改造、对外行为不变)的标准工作流。当用户要求"重构这段代码/这个模块""把业务逻辑从入口层提取到服务层""在保证行为不变的前提下改造分层结构""迁移/重写既有实现(如页面迁移、接口协议迁移)""批量同构改造(把 N 个 X 都改成 Y)"时使用——先把重构规则固化为契约(目标形态 + 不可变更项 + 验证命令),改造前建立可复跑的测试基线,改造与审查分离(独立只读子代理对抗性审查),按「编译 → 审查 → 测试」循环验证,最后输出重构报告并按规范提交 git。即使未明确说"用 skill",只要涉及结构改造、分层/职责重构、实现迁移或重写、批量同构改造就应使用。小范围优化(可读性、重
repo-init仓库指引初始化(`/init` 的等价实现,指引正文统一归 AGENTS.md):为项目首次接入 Claude Code 时生成或更新 agent 指引文档(含给既有 AGENTS.md 增补规范条款,如提交 / 分支命名约定),正文一律写入 AGENTS.md(唯一权威源,与既有内容合并、不覆盖),CLAUDE.md 只保留指向 AGENTS.md 的声明、不承载内容。当用户要求"初始化这个项目 / 仓库""执行 /init""生成或补全 CLAUDE.md / AGENTS.md 的指引""给新克隆的仓库做 agent 指引""给仓库加个分支 / 提交规范"时使用——先探索仓库(READM
session-summary会话总结与 skills 迭代——把一次 Claude Code 会话收尾为「做了什么 → 发现的问题与教训 → 当前 skills 的优化点评估 → 实施」,作为迭代本仓库全部技能的工具(session-summary 自身也在迭代范围内)。当用户要求"总结这次会话""看看 skills 有没有可优化的地方""把这次的经验沉淀进技能"时使用——先取证会话实际动作(git log 提交、对话要点),再对照各技能(SKILL.md / references / 脚本)评估:本次暴露的问题对应哪个技能缺什么能力、哪些教训应固化;会话操作的是另一个项目仓库时,还要把该仓库实证过的教训回流进它自己的
skill-router技能路由判断——任务描述无法唯一确定技能(用户未指定 / 多技能重叠 / 边界模糊)时,盘点环境里实际可用的技能,按任务特征归类、用各技能 description 的边界互指排除,AI 判断给出「推荐技能 + 理由 + 备选」,并最后输出可直接复制的派发指令——按目标技能自身 `## 输入` 的格式把用户原话优化为结构化任务描述,已确认信息带入、缺失项标注,让下次调用目标技能免于重复问答;只判断不代执行。当用户要求"这个需求该用哪个技能""帮我选个技能""不确定用哪个技能""看看有没有合适的技能"时使用;用户没指定技能、候选技能又不止一个时同样适用——**不确认时由 AI 判断并给出理由**,
spec-route规范路由的标准工作流——项目约定以 AGENTS.md 为唯一权威源。当需要"按场景定位 AGENTS.md 里的约定章节""确认某写法是否合规""查某类改动的规范要求"时使用——正文只做「场景 → 章节」的定位与按段加载:先用 Grep 定位章节标题,再用 Read + offset/limit 只读目标段,不全文加载 AGENTS.md;引用时给出出处(文件:行),不复制约定内容。项目没有 AGENTS.md 时本技能不适用。即使未明确说"用 skill",只要涉及"按项目约定查要求"就应使用。约定与代码不一致时用 doc-sync;修订约定本身直接改 AGENTS.md。
task-commander任务指挥与编排——接到任务后由主代理先分析任务,再做规划与拆分(子任务序列 + 映射技能),规划经选择工具 AskUserQuestion 交用户确认后,把每个子任务派子代理、按映射到的技能执行;执行中发现的分歧或不确定事项回收给用户选择确认后才继续;指挥者自身不执行任务正文(不写文件、不改代码、不查数、不跑命令),只做分析与编排调度。当用户要求"帮我安排/统筹/指挥这个任务""把任务拆一拆让子代理干""这个任务分给几个技能协作",或任务含糊、跨多类技能需要先规划再执行时使用——意图分析与任务改写显式转 skill-router(未安装时降级为自带粗判、候选全数交用户选择)。用户已明确指定技能
unit-test单元测试工作流(生成 / 修复失败两类)。当用户要求"给如下代码生成单元测试"(覆盖主要逻辑分支与关键边界、可运行可通过、遵循项目现有测试规范与风格),或给出失败的单元测试执行结果要求"保证这些单元测试可以通过"时使用——修复失败类默认只改代码、不自行执行测试,改完交用户执行验证;生成类须验证可运行;不为变绿而弱化断言、删用例或改正确预期。即使未明确说"用 skill",只要涉及单元测试的编写或修复就应使用。缺陷根因定位与生产代码修复用 bug-fix;从需求分析到落地的完整开发流程(单测只是其中一步)用 feature-dev;结构性改造与重构用 refactor。
Maintain dev-skills?
This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.