关于 ns-best-practices
ns-best-practices 是用于检查 Web 应用、网关和静态资源质量与安全卫生的技能。它按需检查安全性、兼容性、无障碍和界面规范,并可报告问题;用户要求时也可进行最小修复。
主要功能
- 01安全配置与依赖检查
- 02浏览器兼容性基线审查
- 03快速无障碍检查
- 04Web 界面规范审计
- 05按严重程度整理问题与建议
适用场景
- 01检查安全标头或依赖
- 02审查浏览器兼容性
- 03检查页面地标、标签和替代文本
- 04评估界面规范符合度
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nextstage-brasil/ skills --skill ns-best-practices安装后在 Claude Code 中输入/ns-best-practices确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
evals/evals.jsonreferences/checklist.mdui-guidelines-review.md详细介绍
最佳实践
聚焦于质量 + 安全卫生检查——不能替代资深代码审查或视觉设计指导。
会话启动
参见 ../ns-harness/references/session-boot.md。阅读 architecture-rules.md 和与安全相关的 harness 规则。
适用场景
| 请求 | 此技能 | 改用 |
|---|---|---|
| 安全标头 / CSP / HSTS | 是 | — |
| 依赖项审计 / 已知 CVE 扫描 | 是 | — |
| 浏览器兼容性基线检查 | 是 | — |
| 无障碍快速检查(地标、替代文本、标签) | 是 | — |
| “审查我的 UI” / Web Interface Guidelines / UX 无障碍审计 | 是(references/ui-guidelines-review.md) | — |
| 鲜明独特的视觉重新设计 / 反平庸美学 | 否 | ns-frontend-design |
| “审查此 MR” / SOLID 深入分析 | 否 | ns-reviewer |
| 新功能实现 | 否 | ns-coder / ns-spec-driven |
工作流
- 范围 — Web 应用界面、API 网关、静态资源或
prototype/。 - 基线 — 阅读
references/checklist.md;仅勾选适用部分(离线安全性 / 兼容性 / 无障碍)。 - 指南 — UI / 无障碍 / UX 审计,或调用方为
ns-proto-creator的收尾工作:完整阅读references/ui-guidelines-review.md(内置规则;不从外部获取内容)。 - 扫描 — 配置(nginx、Vite、Next、Laravel 中间件等);不假设技术栈。
- 报告 — 发现项表格:严重程度、位置(尽可能注明
file:line)、建议、工作量。 - 修复 — 用户要求实现时,进行最小且安全的差异修改;否则仅报告。
与其他技能的重叠
- 此技能: 跨领域卫生检查 + Web Interface Guidelines 合规性。
- ns-frontend-design: 鲜明独特的外观、字体排印、动态效果、反通用 AI 界面。
- ns-reviewer: 针对变更差异检查 SOLID、测试和可维护性。
交付时可按顺序使用——面对明确的技能请求时,应进行路由分配。
禁止事项
- 在没有证据的情况下宣称生产环境安全
- 未指出风险就破坏现有集成
- 对高风险领域以威胁建模替代审查(升级交由人工处理)
- 在 UI 审计 / 原型收尾工作中跳过
references/ui-guidelines-review.md,却声称已完成全面 UI 检查
评论
支持 Markdown