Agent Skills
› dzhng/skills
dzhng/skills
GitHub用于评估和改进 Agent Skill，通过盲测对比输入与预期输出，驱动技能修复。
Install All Skills
npx skills add dzhng/skills --all -g -y
Skills in Collection (23)
用于评估和改进 Agent Skill，通过盲测对比输入与预期输出，驱动技能修复。
用户要求测试或评估某个 skill
用户提供 golden case 期望结果
npx skills add dzhng/skills --skill eval-skills -g -y
指导创建或修订 Agent Skill，强调将 Skill 作为可预测的操作记忆而非文档。涵盖触发器设计、Token 优化、渐进式披露及验证方法，旨在提升 Agent 行为的一致性和效率。
新增 Agent Skill 文件
修改或简化现有 Skill
优化 Skill 触发描述
界定 Skill 与参考文档的边界
npx skills add dzhng/skills --skill write-skills -g -y
用于审计和优先处理性能问题，通过追踪热点路径、计算放大效应及检查前向进展，识别无界或停滞工作。生成证据报告并按策略排序，推荐最小化修复方案以恢复系统健康。
查找性能问题
调查冻结或500错误
审查重试或轮询逻辑
对性能积压任务进行排序
npx skills add dzhng/skills --skill audit-performance -g -y
用于通过快速渐进式实验映射可调参数及其影响，优化代码、提示词或配置。包含状态恢复、明确成功标准、定义最小循环及基线测试，旨在提升单位时间内的学习效率并生成参数效果映射。
需要优化代码、提示词或配置
需要规划假设队列进行长期研究
需要对齐目标或基准进行测试
npx skills add dzhng/skills --skill auto-research -g -y
指导如何调用 Claude Code 作为独立子代理，用于获取第二意见或委托具体任务。涵盖模型选择、思维层级设置、提示词工程及代码审查规范。
用户明确要求使用 Claude
需要获取 Claude 的第二方意见
委托特定范围的任务给 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
协调AI代理Codex执行代码实现，人类负责编排、集成与审查。适用于需使用Codex进行规范实现的场景，确保代码质量与验证闭环。
用户要求使用Codex实现规范
需要运行implement-spec并由Codex作为实现者
npx skills add dzhng/skills --skill implement-spec-with-codex -g -y
指导Agent按规范分步实现功能，支持并行子任务与多轮迭代。强调每阶段代码清理、测试验证及架构优化，确保长期维护性与质量。
需要按计划逐步实现复杂功能
存在待执行的开发规范或Spec
npx skills add dzhng/skills --skill implement-spec -g -y
营销页面最佳实践规则，涵盖活动落地页、产品页等分类的SEO、导航及转化规范。用于编写/更新营销页、配置追踪标识或审计索引与可达性。
编写或更新营销落地页
配置广告归因标识
审计网站索引与转化设置
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 等核心文档
文档中罗列了代码已包含的具体场景、类 ID 或命令矩阵
需要修剪文档中的叙事性或变更日志内容
处理重复文档并建立根文档与子文档的链接关系
npx skills add dzhng/skills --skill write-docs -g -y
指导编写行为驱动测试的规范，强调断言可观测的外部行为而非实现细节。适用于新增测试、修复脆弱测试及重构回归场景，确保测试仅在实际行为故障时失败。
添加新功能测试
编写回归测试
修复不稳定或脆弱的测试
审查测试差异
重构后测试失效
npx skills add dzhng/skills --skill write-tests -g -y
指导WebGPU渲染器开发，涵盖场景层、节点材质及WGSL着色器。规范GPU资源管理、Pass编排与深度语义，强调单一职责与浏览器视觉验证，确保渲染正确性与性能。
修改WebGPU渲染管线或着色器
优化GPU资源布局与内存对齐
调试渲染可视化效果或性能问题
重构渲染层共享合约与资源所有权
npx skills add dzhng/skills --skill renderer -g -y
用于UI、游戏或渲染资产的视觉对比，通过建立目标基准而非依赖旧基线，客观评估图像差异并判定哪个结果更准确。
需要对比两个截图以判断哪个更符合设计意图
对单个截图进行质量审查，检查是否空白或构图错误
npx skills add dzhng/skills --skill compare-screenshots -g -y
在macOS上将精选的图像截图整合至单个Preview窗口进行视觉审查，支持自动排序、添加说明及清理多余窗口，确保用户高效比对基准与结果。
用户要求打开或查看截图以确认视觉效果
生成视觉产物后需用户签字确认前
npx skills add dzhng/skills --skill preview-shots -g -y
通过无偏见的子代理对截图进行视觉审查，用于在修复或验证视觉工作前发现缺陷。
用户报告的视觉错误修复后验证
视觉变更的验收审查
npx skills add dzhng/skills --skill screenshot-critique -g -y
审计AI实现过程中自主做出的架构与决策，而非代码差异。通过追溯会话历史生成决策清单，帮助用户在合并前审查未授权的隐性选择，确保未来工作继承正确的架构设计。
用户希望审查AI代为做出的决策
合并或提交AI实现的工作前
集成子代理任务后
修复看似有效但可能不稳健时
npx skills add dzhng/skills --skill audit-choices -g -y
用于在功能上线后将开发计划归档为持久化的设计 rationale。通过对比计划与实际代码，记录决策原因、原则和死胡同，并将文件移至完成目录，以保留代码无法体现的设计意图。
功能已合并或上线且测试通过
用户指定某个特性/规格已完成
npx skills add dzhng/skills --skill close-spec -g -y
通过四象限引导式对话梳理任务中的已知与未知，适用于需求模糊、领域陌生或需消除歧义的场景。帮助在编码前明确意图与边界，产出完整映射图，降低返工风险。
请求含糊不清或未充分定义
代码库或领域不熟悉
需要理解参考实现后再移植
构建过程中偏离计划需记录
合并前需确认理解或获得认可
npx skills add dzhng/skills --skill explore-unknowns -g -y
将大型功能拆解为可独立验证、人类可审查的切片，通过前置提问、API边界切割和可视化检查点，制定分步实施计划。
需要规划复杂或高风险功能的开发路径
需要将大任务分解为可测试的小步骤
npx skills add dzhng/skills --skill write-spec -g -y
