用途：为 modern-web-guidance-src（guidance）仓库提供架构原则、编码约定与 PR 审查标准，在编写 TypeScript、JavaScript、CLI 命令、harness 工具、服务端接口或仪表盘代码时使用。
主要能力与约定： PR 范围与模块化：保持 PR 聚焦单一目的，不把后端数据模型、CLI 工具与前端 UI 混在一个 PR；大型功能拆成数据层/核心库、CLI 工作流、UI 可视化等递进式小 PR。 架构原则：与 LLM 交互或执行 agent 工作流时复用仓库抽象（如 config.environment.jetskiCliBin、config.environment.geminiCliBin），不写自定义 REST 客户端或临时 fetch 循环；尊重标准环境开关（如 GD_DEV_USE_GEMINI === '1'），非必要标志省略（如非交互或诊断任务省略 --yolo）。 单一事实来源与枚举：不硬编码 agent 或 serving 模式字符串，使用 harness/config.ts 中的 Agents（Agents.JETSKI、Agents.CLAUDE_CODE、Agents.GEMINI_CLI、Agents.CODEX_CLI）与 Serving（Serving.MCP、Serving.SKILLS_CLI）；存在 evals.json 等规范元数据文件时，直接从中提取属性，不用路径启发式或正则推断。 提示词与模板：不把长提示模板、系统指令或 markdown 合成模板嵌入运行时 runner 文件，放入专用模块（如 *-prompts.ts）。 文件、Git 与配置完整性：不修改共享根配置（tsconfig.json、.oxlintignore、package.json）来绕过类型检查或 lint；用 TypeScript 接口与类型或 .js 中的定向 JSDoc 修复类型。远程 I/O 严格限定所需前缀与子目录，先查本地缓存；不提交测试输出、调试文件、本地缓存或工作目录，临时数据放 harness/results/ 并由 .gitignore 排除。 前端与仪表盘：评估仪表盘需同时支持静态托管模式（如 GitHub Pages）与本地服务器模式（gd dashboard），依赖本地 Node 服务器的功能需检测静态模式并优雅隐藏或禁用；请求本地端点时传数据源上下文（如 ?source=local）；区分多次运行与时间数据，用显式 run 索引与时间戳；安全解析 URL 查询参数；构造 URL 时清理斜杠避免协议相对 URL（//...）；图表标记、徽章、指示器与提示需在目标元素上水平垂直居中。 验证与测试门禁：提交 PR 前须通过 lint、类型检查与测试。快速开发检查：pnpm typecheck && pnpm lint；完整预检：pnpm run preflight；涉及 eval-view/ 前端可视化、仪表盘或服务端接口时须运行 Playwright 浏览器测试：pnpm --filter eval-view run test:e2e（未安装浏览器二进制先运行 pnpm run setup:playwright）。修改 MCP 服务器或技能打包时用 pnpm --filter serving run publish-skills --dry-run 验证；编写或更新评估胶囊时用 gd dev <guide> --test-grader 验证评分器校准；构建须保持 git status 干净。 代码卫生：不用 eval() 解析数据或 JSON，使用 JSON.parse() 或专用解析器；正则中避免原始或未转义控制字符，使用显式 Unicode 转义（如 [\u001b\u009b]）。
限制：本技能仅针对该仓库的规范与审查流程，不提供通用编程教学；具体命令与配置以仓库实际为准，资料未提供的内容暂未说明。