self-documenting-code-practices
通过良好的编程风格实践自文档化代码,并评估类设计的抽象质量。在编写代码、进行代码审查、设计类接口或建立文档标准时使用。
把 Skill 的源码、资源快照、README、包体和安装信号放进一个可搜索、可筛选的公开目录。
通过良好的编程风格实践自文档化代码,并评估类设计的抽象质量。在编写代码、进行代码审查、设计类接口或建立文档标准时使用。
创建自解压的Bash脚本,使用base64编码嵌入任何载荷(如压缩包、可执行文件、配置文件)。适用于创建便携式单文件安装程序、部署包或分发不依赖外部资源的文件。
在标记PR为准备好之前进行自检 - 以全新的视角捕捉清晰性、正确性和可维护性问题
使用常规提交格式和原子化暂存来管理Git提交。在提交更改、暂存文件或创建提交信息时使用。
编写经过深思熟虑的语义化HTML,以服务于所有用户。在创建组件、页面结构或审查标记时使用。优先使用原生HTML元素而非ARIA。将正确的文档结构和可访问性视为基础而非事后考虑。
在Tailwind项目中强制使用语义化的CSS变量主题。防止直接使用颜色(十六进制、rgb)和非主题的Tailwind类。当项目包含语义化标记、CSS变量或自定义ESLint主题规则时使用。
全面指南,用于集成Semaphore V4零知识协议。在开发匿名投票系统、保护隐私的身份验证、零知识证明、具有组成员身份验证的智能合约或实现Semaphore SDK功能(身份管理、组操作、证明生成/验证)时使用。在修改、升级或调试现有的Semaphore集成时也请参考本指南。
通过macOS上的Apple Mail.app使用电子邮件将EPUB和PDF文件发送到Kindle设备。当用户想要将文档发送到他们的Kindle,传输阅读材料或将文件通过电子邮件发送到他们的Kindle地址时使用。
在编写、审查或重构代码时使用此技能,以确保代码具有自文档化特性。将这些检查清单应用于例程、数据命名、数据组织以及整体代码布局上,从而提高代码的清晰度和可维护性,而不依赖于注释。
在项目中开始任何任务时使用 - 保持CLAUDE.md指令文件与高层次项目状态同步,如果缺少则提示初始化,并在工作前添加反思待办事项以确保文档保持更新
当用户要求“测试技能调用框架”或提到“金丝雀技能测试”时使用。这是一个自测技能,用于验证测试框架能否正确加载和调用技能。
提供散文的格式指南。此技能的指导会在编写多行注释、提交信息、markdown或其他散文时自动应用。
当你想要清除所有索引数据并重新开始时使用
使用Semgrep分析代码的安全漏洞和代码质量问题,然后创建优先级修复计划
.claude 디렉토리 구조 검증 및 자동 수정。使用在以下情况:(1) SEMO 更新后的完整性检查,(2) 怀疑符号链接损坏时,(3) 由version-updater自动调用,(4) 新会话开始时。
通过FastMCP服务器使用Gmail API发送电子邮件,并带有审批工作流。在配置邮件发送、排查邮件投递问题、设置邮件模板或管理邮件发送速率限制时使用。不用于读取邮件(请使用watching-gmail技能)。
预飞珠工作:验证珠子正在使用中,确认明确的开始/继续,识别活动珠或选择下一个`bd ready`,明确完成标准,并在标记为`in_progress`之前进行范围审核。
任务完成前的自我审查。使用Gemini CLI + Claude子代理进行多角度验证。
当其组件发生变化时更新AGENTS.md系统。在修改代理、技能或指令文件时使用。
示例技能展示了自验证REST API的生成与自动测试执行。可以用作创建带有预工具使用验证钩子的技能模板。在生成端点之前验证Node.js环境和依赖项。
在使用自然语言查询(如“认证逻辑”或“数据库连接”)搜索代码库时使用
创建语义插件(连接器、嵌入、分块器、重排器、提取器、代理)。在开发插件、创建新集成或询问有关插件模式、协议或测试时使用。
用于处理离散半导体元件时 - 二极管、晶体管、MOSFET、IGBT。包括添加模式、解析MPN、提取电压/电流额定值和封装代码。
高性能的语义搜索和文档解析工具包。主动使用它来搜索文档、YAML清单、配置文件或任何需要语义理解的文本。在探索不熟悉的代码库、寻找概念上相关的内容,或者当确切的关键字与所需信息不匹配时特别有效。