用途：本技能用于 EdgeSpark 相关实现与工作流决策，而非 EdgeSpark 官方文档。精确契约应查阅源码、生成类型、CLI 帮助与 docs/Mintlify MCP；本技能聚焦工作流、护栏与缺陷预防。
主要能力与依赖：可靠的公开面包括 edgespark CLI、edgespark init 脚手架结构、生成的 src/generated/edgespark.d.ts 与 server-types.d.ts、@edgespark/web 浏览器 SDK。可参考旧示例但不盲目沿用旧模式，尤其不要将 @edgespark/client 与 renderAuthUI() 当作新代码默认路径。
读取顺序：按需先读 edgespark.toml、仓库/项目 agent 指令文件（AGENTS.md、CLAUDE.md 或 GEMINI.md）、两个生成类型文件、src/defs 下相关文件，以及已安装时 node_modules/@edgespark/web/dist/index.d.ts，然后按需加载具体参考：dev-workflow.md、project-structure.md、server-patterns.md、web-patterns.md、auth-patterns.md。
硬性规则：运行任何 edgespark 命令前先执行 edgespark <command> --help；代用户运行 edgespark 命令，仅将必须人工浏览器操作的步骤交还用户；禁止并行运行多个 edgespark 命令；生成类型文件在 edgespark pull types 填充前视为占位符；不得编辑 src/generated/ 下文件；新浏览器代码用 @edgespark/web；应用 API 调用用 es.api.fetch()，不用裸 fetch()；托管认证 UI 用 authUI.mount()，自定义浏览器认证流程用 client.auth；从 edgespark/http 导入 auth；认证为 /api/_es/auth/ 托管服务，OAuth 回调 URL 为 /api/_es/auth/callback/<provider>；db 用 db.batch() 而非 db.transaction()；schema 变更走迁移工作流，不用 edgespark db sql 执行 DDL；S3 URI 存库并返回预签名 URL；客户端上传生成预签名 PUT URL；使用 vars.get() 或 secret.get() 前更新 src/defs/runtime.ts。
默认流程：已有项目先读生成类型，再读相关 defs 文件；新脚手架先看 edgespark.toml 确认服务端或全栈布局，生成文件为占位符时先运行 edgespark pull types。遇到困难时重读生成类型、运行 --help，或使用文档 MCP。限制：本技能不含官方文档内容，缺失信息以生成类型与源码为准。