Agent Skills
› dzhng/skills
dzhng/skills
GitHub审计并优化 AGENTS.md，确保仅保留长期有效的原则。通过审阅、重写、迁移或删除过时内容，提升文档对未来的指导价值，仅在用户明确要求时执行。
Install All Skills
npx skills add dzhng/skills --all -g -y
Skills in Collection (36)
审计并优化 AGENTS.md，确保仅保留长期有效的原则。通过审阅、重写、迁移或删除过时内容，提升文档对未来的指导价值，仅在用户明确要求时执行。
用户要求审计 AGENTS.md
用户要求重写 AGENTS.md
npx skills add dzhng/skills --skill audit-agents -g -y
用于评估和改进特定技能。通过隔离环境盲测技能输出，对比黄金案例与预期结果，识别差距并驱动编辑优化，确保技能在真实场景下的判断力与合规性。
用户要求测试或评估某个技能的准确性
用户反馈技能持续产生错误或遗漏特定内容
用户提供技能及输入输出对以进行优化
npx skills add dzhng/skills --skill eval-skills -g -y
指导如何创建和修订Agent技能文件，强调通过触发描述、精简Token使用、编写过程而非文章以及渐进式披露来提升Agent行为的可预测性。
新增或重命名技能文件
优化现有技能的触发描述
决定内容属于技能还是参考文档
npx skills add dzhng/skills --skill write-skills -g -y
审计并优先处理性能问题，通过追踪热点路径、计算放大效应及检查前向进展，识别无限循环或资源泄漏。生成证据报告，依据策略推荐最小修复方案，适用于排查卡顿、OOM及优化性能积压任务。
查找性能问题
调查系统冻结、500错误或内存溢出
审查重试或轮询逻辑
对性能积压任务进行优先级排序
npx skills add dzhng/skills --skill audit-performance -g -y
用于审计测试用例的价值与维护成本，识别冗余、耦合及无效测试。通过分析断言证据与合约归属，制定保留、合并或删除方案，旨在降低维护负担同时保持或提升置信度，并指导后续修改。
修剪冗余测试
调查实现耦合
审查新增覆盖率的值
审计子系统测试
npx skills add dzhng/skills --skill audit-tests -g -y
通过快速渐进式实验映射可调参数及其影响，优化代码、提示词或配置。适用于需规划假设队列、集中测试及持久化结果的长周期研究任务。
优化代码或配置性能
运行需要假设队列的长期研究
针对目标或基准进行参数调优
npx skills add dzhng/skills --skill auto-research -g -y
作为独立子代理调用 Claude Code，用于获取第二意见或委托具体任务。支持配置模型、思考深度及成本预算，强调提示词结构化、单一任务原则及结果验证，确保操作安全与准确。
用户明确要求使用 Claude
需要获得独立的第二意见
委托范围明确的具体任务
npx skills add dzhng/skills --skill claude -g -y
指导代码审查，确保命名准确、无废弃引用、逻辑简化、注释解释原因而非过程，并分离安装与运行时逻辑。
用户要求审查代码
实现工作完成后提交前
审计代码质量
npx skills add dzhng/skills --skill code-review -g -y
指导如何调用本地 Codex CLI 作为独立代理，涵盖安装验证、结构化提示技巧及代码审查流程。
需要第二意见进行代码审查
用户明确要求使用 Codex 执行任务
npx skills add dzhng/skills --skill codex -g -y
将技术规格或变更解释为通俗易懂的说明，涵盖问题、解决方案及模式变更。适用于向未接触代码的技术读者提供精准且独立的理解模型。
需要解释技术规格
需要说明提出的变更
npx skills add dzhng/skills --skill eli5 -g -y
用于将中断的开发任务交接给另一台机器或代理。收集当前进度、决策、断点及本地状态，更新规格说明并推送至远程，确保新会话能无缝继续工作而不重复已知信息。
需要切换开发环境或代理时
中断正在进行的实现任务需交接上下文
npx skills add dzhng/skills --skill handoff-spec -g -y
协调 Codex 执行代码实现，人类负责编排、集成与审查。适用于需借助 AI 生成代码并严格把控质量与流程的场景。
用户要求使用 Codex 实现规格说明
需要运行 implement-spec 并由 Codex 作为实现者
npx skills add dzhng/skills --skill implement-spec-with-codex -g -y
指导Agent按规范分阶段实现功能，支持并行子任务与依赖管理。每轮提交前清理代码并验证，确保架构整洁、测试通过及视觉正确，防止技术债务积累。
需要按Spec分步实现复杂功能
长周期多Pass的开发任务
需要维护代码整洁和检查点
npx skills add dzhng/skills --skill implement-spec -g -y
营销页面最佳实践规则集，涵盖活动落地页、产品页等分类的索引、导航及转化规范，用于指导页面编写、更新及SEO审计。
编写或更新营销活动落地页
配置站点导航与页脚链接
优化SEO元标签与站点地图
审计公开页面的索引与转化设置
npx skills add dzhng/skills --skill marketing-pages -g -y
指导如何将现有代码库的功能完整移植到新环境，强调保留上游代码的原始逻辑、历史修复及行为细节，避免重写导致遗漏。
需要将功能从旧仓库迁移到新框架或宿主环境
要求复制并移植现有功能以保留原有行为和修复
npx skills add dzhng/skills --skill port-features -g -y
提供系统性重构指南，通过重命名、消除冗余、拆分或合并模块来清理代码债务。适用于处理陈旧名称、重复概念、过度负载模块及兼容性包装器，确保每个概念有唯一归属并删除无用机制。
请求重命名文件或符号
发现代码中存在重复逻辑或概念
模块职责过重需要拆分
存在遗留的兼容性包装器或适配器
代码中存在误导性命名或陈旧引用
npx skills add dzhng/skills --skill refactor-clean -g -y
该技能用于对已完成的实质性代码变更进行最终审查，确保其形态、差异和文档均符合要求。通过按序执行重构清理、代码审查和文档更新三个步骤，并处理循环修正，最终给出综合判定结果。
用户要求对功能或切片进行最终审查
用户要求进行清理和文档更新的审查流程
用户要求“审查所有内容”
npx skills add dzhng/skills --skill review -g -y
指导编写和维护项目文档，强调文档应作为原则 glossary 而非代码镜像。核心规则包括：只保留无法通过 grep 获取的原理性信息（如 WHY），剔除代码已包含的枚举和变更日志；采用“指向而非转录”策略，建立单一事实源并构建文档树结构以避免重复和维护漂移。
创建或修订 README 等核心文档
文档中罗列了代码已存在的精确列表、场景或命令矩阵
需要精简文档中的叙事性或变更日志内容
发现文档间存在重叠，需去重并建立根文档与子文档的链接
npx skills add dzhng/skills --skill write-docs -g -y
指导编写关注真实行为而非实现细节的测试，涵盖端到端测试策略、断言原则及工作流。
新增功能测试
修复脆弱或易失败测试
重构后回归测试
npx skills add dzhng/skills --skill write-tests -g -y
指导生成专业级产品发布视频，涵盖故事挖掘、视觉概念设计、音画同步制作及最终渲染交付。
需要制作产品宣传视频或演示片
请求为CLI、库或项目创建推广短片
要求生成社交媒体发布的动画介绍视频
npx skills add dzhng/skills --skill launch-video -g -y
提供基于TypeGPU/WebGPU的GPU渲染架构规范，涵盖渲染通道、着色器、帧编排及性能优化。指导开发者在修改渲染逻辑时遵循固定视图成本、细节投影大小等原则，确保视觉正确性与资源管理一致性。
添加或修改渲染通道
编写或调整着色器
进行GPU资源管理
处理剔除、地形或阴影逻辑
优化视觉性能
npx skills add dzhng/skills --skill renderer -g -y
根据文章内容生成Ian风格的小黑插画，用于文章、博客或文档的视觉表达。支持分析核心观点并输出分镜列表，按规则生成16:9手绘风插图，默认使用英文标注。
需要为文章或博客生成配图
请求生成小黑风格的插画
询问插画创意或分镜列表
要求对现有图片进行编辑或重新生成
npx skills add dzhng/skills --skill xiaohei-illustrations -g -y
对比截图与设计目标，通过视觉指标定位差异，区分有效偏差与捕获伪影。用于迭代实现匹配、前后视觉审查及内容质量检查，确保UI还原度。
需要验证UI实现是否符合设计稿
进行视觉回归测试或前后版本对比
npx skills add dzhng/skills --skill compare-screenshots -g -y
通过图像生成探索UI视觉设计方向，迭代实现并对比真实截图与选定概念，确保开发成果与设计高度一致。
探索UI视觉设计方向
提供Mockup变体
实现已批准的生成式设计
npx skills add dzhng/skills --skill design-with-images -g -y
在macOS上将图片截图或渲染结果汇总至单一Preview窗口以便人工审查。支持自动清理旧窗口及无响应时自动关闭，确保视觉对比高效且避免多窗口堆积。
用户要求打开或查看截图/快照
生成视觉产物后需用户确认
npx skills add dzhng/skills --skill preview-shots -g -y
通过无背景子代理对截图进行独立视觉审查，识别布局、渲染等缺陷。适用于在修复或验证用户报告的视觉Bug前，获取第二方客观评估，确保视觉质量。
修复视觉Bug后需验证
声称视觉变更已核实
npx skills add dzhng/skills --skill screenshot-critique -g -y
用于审计AI代理在实现过程中自主做出的架构与决策选择，而非代码差异。通过追溯会话历史生成决策账本，帮助用户在合并前审查未明确指定的技术选型、依赖及权衡，确保用户知晓并拥有这些隐含决策。
合并或提交AI实现的代码前
集成子代理的工作结果时
修复看似有效但可能存在隐患的代码时
npx skills add dzhng/skills --skill audit-choices -g -y
审计AI代理在实现过程中自主做出的架构决策，生成决策账本。不修改代码，仅通过追溯会话历史暴露用户未显式授权的隐性选择，辅助用户在合并前审查潜在风险与架构影响。
用户希望在合并或提交前审查AI的隐性决策
集成子代理工作流后需要审计其决策链
修复看似有效但可能掩盖架构问题的点修复
npx skills add dzhng/skills --skill audit-decisions -g -y
用于特性开发完成后归档规范文档，将其从构建计划重写为持久化的设计 rationale（记录原因、原则与代码映射），确保知识沉淀。
用户声明功能或规范已完成
实现已合并且测试通过
npx skills add dzhng/skills --skill close-spec -g -y
引导用户通过四象限法梳理任务未知项，适用于需求模糊、领域陌生或需确认理解的场景。分阶段探索已知/未知信息，生成完整地图后再进入实现，降低返工风险。
需求描述模糊或不完整
对代码库或业务领域不熟悉
需要在编码前消除不确定性
需要获取利益相关者对变更的理解与认可
npx skills add dzhng/skills --skill explore-unknowns -g -y
管理源代码文件体积，防止超过Agent读取限制。提供文件拆分策略、预提交钩子配置及忽略机制，确保代码可维护性。
文件过大导致提交被阻止
需要拆分巨型或God文件
需设置文件尺寸限制或钩子
npx skills add dzhng/skills --skill ratchet-files -g -y
对编码会话进行回顾，分析代理在导航、自动化检查、编码标准等方面的不足，提出环境改进建议以提升未来运行效率。
用户要求进行编码会话回顾
分析代理执行过程中的改进点
npx skills add dzhng/skills --skill retro -g -y
将大型功能拆解为可独立验证的切片，通过前置调研、API边界切分和可视化检查点，生成结构化的开发规范文档。
需要规划复杂新功能
进行大规模功能重构前的规格设计
npx skills add dzhng/skills --skill write-spec -g -y
指导以电影级视觉风格制作软件UI宣传视频，涵盖镜头语言、光影与剪辑。适用于生成产品宣传片、功能预告片或英雄镜头等营销素材。
生成产品宣传片
制作功能预告片
创建英雄镜头
设计UI展示视频
npx skills add dzhng/skills --skill cinematic-shot -g -y
用于构建具有特定“Anatomy”风格的等距动画和交互元素，支持SVG/HTML/React及WebGL。适用于技术文档、博客或着陆页中的系统原理图解与动态示意图。
需要制作等距风格的动画演示
生成交互式技术图解或机制说明
创建类似Linear风格的精密技术绘图
npx skills add dzhng/skills --skill isometric-motion -g -y
利用 harness 的 goal 功能，根据提供的规格说明书完成实现任务。需参考 implement-spec 技能文档进行操作，旨在通过目标驱动的方式将规范转化为完整代码实现。
需要基于规格说明书进行代码实现
使用 harness 的 goal 功能推进开发任务
npx skills add dzhng/skills --skill implement-spec-with-goal -g -y
