用途
该技能用于系统化地构建、调试和架构 Web 应用,强调代码质量、架构设计与调试。每个编码任务都遵循同一核心循环:理解 → 规划 → 构建 → 验证 → 优化。小任务(修 bug、加字段)只需 30 秒思考,大任务(新功能、架构变更)则每步都认真对待。
主要能力
- 项目理解:写代码前先定位代码库,检查项目根目录的配置文件(package.json、tsconfig、.env.example、docker-compose)以了解技术栈,查看目录结构了解既有约定,阅读要修改区域的现有代码以匹配模式,检查 README、CONTRIBUTING.md 或 docs/ 文件夹。上下文缺失时提出正确问题:运行时环境、已安装依赖、既有模式、部署目标。不假设技术栈,从代码库推断或询问。
- 架构决策:按功能而非类型组织文件与文件夹;区分 UI、状态、数据、逻辑等关注点;API 设计保持命名、错误响应、版本、分页一致;数据库使用迁移、索引、边界验证、软删除。
- 代码质量模式:按用户错误(400)、系统错误(500)、程序员错误分类处理错误;使用类型化错误类或结果类型;在边界捕获错误;前端使用错误边界;TypeScript 中类型化 API 响应、使用可辨识联合、优先 unknown 而非 any、避免过度复杂泛型。
- 测试策略:按优先级测试关键路径、复杂逻辑、集成点、UI 交互;不测实现细节、简单 getter/setter、框架内部、样式属性;测试结构采用 Arrange-Act-Assert,命名使失败时无需读测试体即可知道问题。
- 调试工作流:可靠复现 → 隔离层 → 阅读实际错误 → 形成假设 → 验证修复。提供症状与排查起点对照表,以及浏览器 DevTools、服务器日志、数据库查询日志、git bisect、最小复现等工具。
- 性能模式:前端关注关键渲染路径、LCP、TTI、图片优化、代码分割、防抖、记忆化、虚拟列表;后端关注数据库瓶颈、explain/analyze、索引、避免 N+1、缓存、API 响应时间、连接池、分页、边缘缓存。
- 安全要点:验证所有输入、参数化查询、转义输出、全站 HTTPS、哈希密码、管理密钥、配置 CORS 与 CSP、使用短期令牌并存储在 httpOnly cookie、实施速率限制。
- 部署与 DevOps:区分开发、预发、生产环境;使用 .env.example 模板,启动时验证必需环境变量;CI/CD 在 PR 上运行测试、lint 和类型检查,保持流水线快速,自动部署到预发,生产部署设手动门禁,使用预览部署;从第一天起具备错误跟踪、正常运行监控、性能监控、结构化日志。
- 代码审查清单:按顺序检查是否工作、是否安全、是否正确、是否可读、是否可维护、是否测试。
- 重构指南:在代码正确但难以使用时重构;不在同一提交中重构和改变行为;安全重构步骤包括写测试捕获当前行为、做结构变更、验证测试通过、单独提交重构。
- 外部 API 处理:设置显式超时、对瞬时错误重试并指数退避、使用断路器、验证响应形状、记录请求/响应元数据。
使用方式
该技能以技能包形式提供,包含参考文件。例如 references/project-scaffolding.md 提供从零开始新项目的模板和清单,包括常见配置文件、初始文件夹结构和流行框架的引导命令。用户可在编码任务中调用该技能,使其按核心循环和上述模式指导开发。
适用场景
适用于构建、调试和架构 Web 应用的全栈开发任务,包括新项目搭建、既有项目功能开发、bug 修复、性能优化、安全加固、部署配置和代码审查。
限制
资料未提供该技能的具体安装命令、支持的平台、收费方式或价格信息。