Agent Skills
› dzhng/skills
dzhng/skills
GitHub用于评估和改进 Agent Skill，通过在隔离环境中盲测技能对黄金用例的表现，对比预期结果以发现缺陷并驱动编辑。
Install All Skills
npx skills add dzhng/skills --all -g -y
Skills in Collection (22)
用于评估和改进 Agent Skill，通过在隔离环境中盲测技能对黄金用例的表现，对比预期结果以发现缺陷并驱动编辑。
用户要求测试、评估或改进某个 Skill
提供 Skill 及输入到期望输出的对照案例
npx skills add dzhng/skills --skill eval-skills -g -y
指导创建或修订 Agent Skill，定义技能文件规范。涵盖触发机制、Token 优化、流程编写、渐进式披露及验证原则，旨在提升 Agent 执行的可预测性与行为一致性。
创建新的 Agent skill 文件
修订或简化现有 skill
改进 trigger 描述
决定内容归属（skill vs 文档/脚本）
npx skills add dzhng/skills --skill write-skills -g -y
用于审计和优先处理性能问题，通过追踪热点路径、计算放大效应及检查正向进展来识别无界或重复工作。提供证据支持的报告，并指导实施最小化修复以保留系统自愈能力。
查找性能问题
调查冻结/500错误/OOM
审查重试或轮询导致的无进展循环
对性能积压任务进行排序
实施简单的性能修复
npx skills add dzhng/skills --skill audit-performance -g -y
作为独立子代理调用 Claude Code，用于获取第二意见或委托明确范围的任务。支持模型选择、思考层级及预算控制。强调提示词结构、任务拆分、只读审查及结果验证，确保变更范围可控且证据确凿。
用户明确要求使用 Claude
需要第二个 Agent 的意见
委托特定范围内的任务给 Claude
npx skills add dzhng/skills --skill claude -g -y
用于审查代码变更，检查命名准确性、过时引用、逻辑复杂度及注释质量。适用于实现完成后提交前或用户要求审计时，确保代码简洁且文档仅记录原因而非过程。
用户要求审查代码
完成编码准备提交
执行代码审计
npx skills add dzhng/skills --skill code-review -g -y
指导作为独立第二代理使用本地 Codex CLI，涵盖安装验证、结构化提示技巧及主动代码审查流程。
用户要求使用 Codex 进行代码审查
用户明确要求委托 Codex 执行实现任务
需要获取关于实质性变更的第二意见
npx skills add dzhng/skills --skill codex -g -y
将技术规格或变更解释为准确易懂的心理模型，涵盖问题、解决方案及所有Schema变更。面向未接触代码的技术读者，通过具体场景和伪代码提供精确描述，确保输出独立完整。
需要向非当前项目成员解释复杂技术方案
撰写变更文档以说明业务逻辑和数据结构影响
npx skills add dzhng/skills --skill eli5 -g -y
协调 Codex 执行代码实现，人工负责编排、集成与审查。适用于需使用 Codex 进行规范实现的场景，强调人工对结果的全权验证与质量把控。
用户要求使用 Codex 实现规范
需要运行 implement-spec 并指定 Codex 为实施者
npx skills add dzhng/skills --skill implement-spec-with-codex -g -y
用于按阶段逐步实现需求规范，支持并行子任务与代码清理。触发于需分步交付、维护检查点及处理长周期或多轮迭代的开发任务。
需要分多轮迭代实现复杂功能
需在开发过程中定期清理代码和更新计划
存在多个可并行的独立开发切片
npx skills add dzhng/skills --skill implement-spec -g -y
营销页面最佳实践规则，涵盖活动落地页、产品页等分类的索引、导航及转化规范，指导写作、更新与审计。
编写或更新营销/落地页
配置活动归因标识
修改全站导航或页脚链接
处理 sitemap/robots 配置
审计公开站点的索引与转化设置
npx skills add dzhng/skills --skill marketing-pages -g -y
指导代码重构，消除重复概念、过时适配器和过度耦合模块。通过识别清晰所有权、合并或拆分职责、删除冗余路径来简化代码结构，确保行为一致并减少技术债务。
发现代码中存在重复的概念或逻辑
模块职责过重需要拆分
存在过时的包装器或兼容层
代码因累积变更变得难以维护
npx skills add dzhng/skills --skill refactor-clean -g -y
协调重构、代码审查和文档更新的顺序工作流，确保变更完成。适用于功能实现后、提交前的最终检查或用户请求的全面审查与清理场景。
实现功能切片后准备提交前
用户请求最终审查
用户请求清理和文档更新
npx skills add dzhng/skills --skill review -g -y
指导编写和维护项目文档（如README），强调文档应作为原则词表而非代码镜像。核心规则包括保留非显而易见的设计原理，剔除可由代码直接推导的具体清单和变更日志，确保每个事实有唯一权威来源并建立向下链接的文档树结构。
创建或修订项目 README
文档中包含与代码重复的具体场景、类ID或命令矩阵
需要精简文档中的叙事性或变更日志内容
合并重叠文档并建立根文档到子文档的链接
npx skills add dzhng/skills --skill write-docs -g -y
指导编写高鲁棒性测试的规范，强调断言真实行为而非实现细节。适用于新增测试、回归测试、修复脆弱或易碎测试，以及重构后验证行为一致性的场景。
添加新功能的测试用例
编写回归测试
修复脆弱或易碎的测试
审查测试差异
重构后测试失败
npx skills add dzhng/skills --skill write-tests -g -y
指导WebGPU渲染器开发，涵盖three.js/TSL场景、WGSL着色器及渲染通道的构建、调试与审查。规范GPU资源管理、Pass编排、深度语义及性能优化，确保浏览器端视觉正确性。
WebGPU渲染器工作
更改GPU资源布局或绑定组
编写或修改WGSL着色器
调试渲染通道或计算着色器
审查帧编排或视觉效果
npx skills add dzhng/skills --skill renderer -g -y
通过多维度视觉指标对比截图，以设计意图为基准判断哪张图更准确。适用于UI、游戏或渲染资产的视觉质量评估与差异分析。
需要对比两张截图的视觉质量
评估UI变更是否符合设计规范
检测渲染或生成图像中的异常
npx skills add dzhng/skills --skill compare-screenshots -g -y
在macOS中批量打开图片至单预览窗口，便于视觉审查。适用于用户要求查看截图、基准图或渲染结果，或在生成需确认的视觉产物后触发。
用户请求打开/显示/拉取/审查截图
生成视觉产物后需用户签字确认
npx skills add dzhng/skills --skill preview-shots -g -y
通过启动无背景知识的子代理对截图进行独立视觉审查，以发现人工检查易忽略的视觉缺陷，确保在修复或验证视觉问题前的客观性。
用户报告视觉Bug需确认修复
声称视觉变更已验证
需要第三方视角审查UI/UX
npx skills add dzhng/skills --skill screenshot-critique -g -y
审计AI实施过程中的自主决策，追溯会话历史生成选择清单，不修改代码。适用于合并前审查、子代理集成或修复验证场景。
用户希望审查AI代为做出的架构决策
在合并或提交AI实现的工作之前
集成已委托的子代理阶段后
修复看似有效但可能存在隐患时
npx skills add dzhng/skills --skill audit-choices -g -y
用于归档已上线的功能规格文档，将其从构建计划重写为包含设计原理、约束和代码指针的持久化记录，并迁移至完成目录。
功能开发完成并已合并
用户指示某个规格已完成
npx skills add dzhng/skills --skill close-spec -g -y
通过四象限引导对话梳理任务未知项，适用于需求模糊、领域陌生或需澄清意图的场景。分阶段探索已知/未知信息，最终交付完整地图以辅助后续开发决策。
需求描述模糊或不完整
面对陌生代码库或领域
需要在编码前消除不确定性
需要获取干系人确认或理解
npx skills add dzhng/skills --skill explore-unknowns -g -y
将大型功能拆解为可独立验证、人类可读的规范切片。通过前置提问、API 边界切分、模糊领域调研及可视化检查点，确保每个切片均可测试且能逐步交付，适用于高风险或多步骤功能开发。
需要拆解大型复杂功能
涉及高风险或多步骤的特性开发
需要对 API 边界进行明确定义和切片
缺乏清晰参考实现需先进行调研
npx skills add dzhng/skills --skill write-spec -g -y
