kdvlop/webdev-skills

# webdev-skills **面向韩语 Web 服务的 AI 代理技能包** — 涵盖从安全到 SEO/GEO、支付、备份、故障响应的 Web 服务全生命周期，共计 20 个技能。 只需在 AI 编码工具（无论是 Claude Code、Cowork 还是 Cursor 等）中安装一次此技能包，不仅是开发者，**非开发者也能通过一行指令将任务委派给专家级别的代理**。所有技能均不绑定特定框架（技术栈不限），并默认以韩国服务环境（Naver 搜索、Kakao 分享/登录、Alimtalk、Toss Payments、个人信息保护法、韩语 Web 字体）为前提。 ``` 이렇게 시켜보세요 — 설치 후 AI 도구에 그대로 붙여넣기: "내 프로젝트 기본 세팅해줘" → project-bootstrap 이 알아서 실행 "보안 점검하고 위험한 것부터 알려줘" → security-hardening "네이버랑 구글에 검색 잘 되게 해줘" → seo-technical "카카오 로그인 붙여줘" → auth-integration "사이트가 왜 이렇게 느리지?" → bottleneck-profiling "출시 전에 빠진 거 없는지 다 점검해줘" → launch-readiness ``` 所有技能在任务完成后，都会输出一份**非开发者也能轻松理解的简明中文报告**（包括做了什么、发现了什么问题、以及用户需要自行处理的事项）。 ## 安装 ### Claude Code (插件 — 推荐) ``` /plugin marketplace add kdvlop/webdev-skills /plugin install webdev-skills@webdev-skills ``` ### Cowork / Claude Code (作为个人全局技能) 在终端中： ``` curl -fsSL https://raw.githubusercontent.com/kdvlop/webdev-skills/main/install.sh | bash -s -- --claude --global ``` ### Cursor 在项目文件夹中： ``` curl -fsSL https://raw.githubusercontent.com/kdvlop/webdev-skills/main/install.sh | bash -s -- --cursor ``` ### 其他工具 (支持所有遵循 AGENTS.md 的工具) 在项目文件夹中： ``` curl -fsSL https://raw.githubusercontent.com/kdvlop/webdev-skills/main/install.sh | bash -s -- --agents ``` 如果不带任何选项运行 (`| bash`)，将会安装以上三种方式。再次运行即可更新至最新版本。 ## 技能目录 (20个) 点击各技能名称，将跳转至包含**面向非开发者的通俗说明 + 可直接复制的 prompt + 面向开发者的详细指南**的中文文档。 ### 快速开始 | 技能 | 说明 | |---|---| | [Web 项目基础初始化](docs/project-bootstrap.ko.md) `project-bootstrap` | 只需一句“初始化基础配置”，即可一次性安全配置安全、搜索 (SEO)、韩语默认值、错误页面及隐私政策框架等 Web 服务基础要素 | | [发布准备检查](docs/launch-readiness.ko.md) `launch-readiness` | 在上线前全面检查域名、安全、搜索、性能、备份等所有环节，并生成 GO/NO-GO 判定报告 | ### 功能开发 | 技能 | 说明 | |---|---| | [登录与会员管理集成](docs/auth-integration.ko.md) `auth-integration` | 安全实现 Kakao、Naver、Google 社交登录、session、实名认证及账号注销等所有账号功能 | | [韩国支付 (PG) 集成](docs/payments-integration-kr.ko.md) `payments-integration-kr` | 接入 Toss Payments、PortOne 等韩国 PG，实现没有金额篡改、重复支付、结算不一致问题的支付/退款/定期付款功能 | | [邮件、Alimtalk 与短信发送](docs/email-messaging.ko.md) `email-messaging` | 构建避免进入垃圾邮件箱的发送系统 (SPF/DKIM/DMARC) 及 Alimtalk、短信功能，并确保遵守广告短信相关法规 | | [API 设计与检查](docs/api-design.ko.md) `api-design` | 按照标准设计 App 与服务器的接口 (API)，预防错误格式、权限漏洞及重复支付等问题 | | [访客分析与转化追踪](docs/web-analytics.ko.md) `web-analytics` | 在遵守 Cookie 同意规则 (PIPA/GDPR) 的前提下，精确统计访客数、流量来源及注册/购买转化率 | ### 安全与合规 | 技能 | 说明 | |---|---| | [安全检查与加固](docs/security-hardening.ko.md) `security-hardening` | 基于 OWASP Top 10 标准查找并修复安全漏洞（如 secret 泄露、injection、认证/权限漏洞、header 配置），并通过工具进行验证 | | [隐私保护与合规](docs/privacy-compliance.ko.md) `privacy-compliance` | 检查并实现从 Cookie 同意、数据映射、注销/数据导出到自动销毁的全流程，确保符合个人信息保护法及 GDPR 标准 | | [数据备份与恢复验证](docs/data-safety-backup.ko.md) `data-safety-backup` | 基于 3-2-1 原则部署备份，并通过实际恢复演练证明数据“确实可以找回” | ### 搜索与曝光 | 技能 | 说明 | |---|---| | [技术 SEO 检查与配置](docs/seo-technical.ko.md) `seo-technical` | 检查并修正 robots.txt、站点地图、meta 标签和结构化数据，确保 Google 和 Naver 搜索机器人能够正确抓取和索引网站 | | [AI 搜索曝光优化](docs/geo-ai-search.ko.md) `geo-ai-search` | 优化爬虫策略、llms.txt 和内容结构，使 ChatGPT、Perplexity、Google AI Overview 等能够将网站作为来源引用 | | [Web 无障碍检查](docs/accessibility-audit.ko.md) `accessibility-audit` | 基于 WCAG 2.2 AA 及 KWCAG 标准检查并修复网站对残障人士的可用性问题 | ### 性能与稳定 | 技能 | 说明 | |---|---| | [Web 性能优化](docs/performance-web-vitals.ko.md) `performance-web-vitals` | 通过数据量化网站速度，从最大瓶颈开始修复，并利用 CI 性能预算防止问题复发 | | [性能瓶颈分析](docs/bottleneck-profiling.ko.md) `bottleneck-profiling` | 将“网站很慢”这类模糊反馈转化为量化指标查明原因，并用修复前后的数据证明改善效果 | | [内存泄漏修复](docs/memory-leak-debugging.ko.md) `memory-leak-debugging` | 针对服务器或浏览器内存持续增长导致变慢或崩溃的问题，找到证据查明原因并修复验证 | | [服务故障响应](docs/incident-response.ko.md) `incident-response` | 网站宕机时优先恢复服务而非分析原因 — 涵盖回滚、分类响应、用户公告及事后复盘 | ### 研发运营 | 技能 | 说明 | |---|---| | [测试策略](docs/testing-strategy.ko.md) `testing-strategy` | 以合理的比例设计单元测试、集成测试和 E2E 测试，并将不稳定测试的处理策略集成到 CI 中 | | [部署自动化 (CI/CD)](docs/ci-cd-pipeline.ko.md) `ci-cd-pipeline` | 搭建涵盖代码检查、零停机部署到回滚的流水线，并确保其安全稳定运行 | | [监控与故障报警](docs/observability-monitoring.ko.md) `observability-monitoring` | 配置日志、指标及错误追踪，甚至通过主动制造故障来验证报警是否能正常触发 | ## 使用方法 技能会被**自动触发**。您无需记忆任何特定命令，只需用日常语言提出您的需求，AI 工具就会找到合适的技能，并遵循其中的工作流程、检查清单和验证方法。 - 首次使用：可以从 **“帮我初始化项目基础配置”** 开始 (`project-bootstrap`) - 准备上线前：输入 **“帮我做完发布前的所有检查”** (`launch-readiness`) — 它会自动参考其他必要的技能 - 每个技能的[中文指南](docs/)中都提供了可以直接复制使用的 prompt 示例 所有技能都内置了代理执行规则：**对于破坏性或难以撤销的操作（如文件删除/覆盖、付费订阅、操作生产环境密钥、修改 DNS 等），必须在获得用户确认后执行**，且绝不会将未实际执行的检查谎报为已完成。 ## 更新 - Claude Code 插件：通过 `/plugin` 菜单进行更新 - 脚本安装：重新运行安装命令即可更新至最新版本 ## 仓库结构 ``` skills//SKILL.md # 스킬 본체 (Agent Skills 표준, 영어 — 에이전트가 읽음) docs/.ko.md # 사람용 한국어 가이드 (비개발자 + 개발자) .claude-plugin/ # Claude Code 플러그인/마켓플레이스 매니페스트 install.sh # Cursor·AGENTS.md·전역 스킬 설치 스크립트 scripts/validate.sh # 스킬 형식 검증 (CI에서 자동 실행) ``` ## 免责声明 `privacy-compliance`、`payments-integration-kr` 等涉及法律与监管的内容仅为工程指南，不构成法律意见。关于上线及合规判断，请咨询专业法律人士。 ## License MIT © [kdvlop](https://github.com/kdvlop) · [nova-lab.dev](https://nova-lab.dev) ## 英文摘要 **webdev-skills** 是一个覆盖 Web 服务完整生命周期的 AI 代理技能包，专为韩语服务优化：包含 20 个与技术栈无关的技能，涵盖安全、技术 SEO (含 Naver)、GEO (AI 搜索曝光度)、性能、内存泄漏、瓶颈分析、无障碍访问 (WCAG 2.2/KWCAG)、API 设计、测试、CI/CD、可观测性、隐私保护 (PIPA/GDPR)、备份与恢复演练、故障响应、韩国支付、社交登录 (Kakao/Naver/Google)、邮件与 KakaoTalk 通知消息、合规的数据分析、一键项目初始化以及发布准备检查。 技能遵循 [Agent Skills](https://agentskills.io) 格式 (`skills//SKILL.md`) 并兼容任何支持该格式的工具。可作为 Claude Code 插件安装 (`/plugin marketplace add kdvlop/webdev-skills`)，或通过 `install.sh` 安装到 Cursor (`--cursor`)、全局 Claude/Cowork 技能库 (`--claude --global`) 及任何支持 AGENTS.md 的工具 (`--agents`) 中。每个技能执行完毕后，都会输出一份非开发者也能看懂并据此操作的通俗语言报告。 由 [kdvlop](https://github.com/kdvlop) · [nova-lab.dev](https://nova-lab.dev) 维护

标签：AI代理, Syscall, Web开发, 开发辅助工具, 插件扩展, 韩国本地化