mcpField
D
dev-frontend

dev-frontend

github.com/idaibin开发640 次安装1 天前更新
代码仓库

关于 dev-frontend

dev-frontend 是一项用于在现有代码库中实施已授权前端改动的技能,强调优先复用、按需遵循设计与技术栈规范,并针对改动行为收集验证依据。

主要功能

  1. 01按适用规范处理改动
  2. 02优先复用维护中的组件与所有者
  3. 03按需选取框架和技术栈参考
  4. 04以低成本证据进行针对性验证
  5. 05报告范围、检查、排除项与缺口

适用场景

  1. 01在现有技术栈中实施前端改动
  2. 02依据所有者和契约核验无改动情形
  3. 03调整框架、路由或样式行为

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/idaibin/skills --skill dev-frontend

安装后在 Claude Code 中输入/dev-frontend确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
assets/
frontend-visual-evidence.example.json
frontend-visual-evidence.schema.json
references/
behavior-first.md
checklist.md
code-quality.md
codebase-design.md
decomposition.md
eval-cases.md
framework-profiles.md
frontend-css-governance.md
frontend-layout-governance.md
frontend-visual-evidence.md
frontend-visual-gate-example.md
interaction-motion-quality.md
openapi-contract-governance.md
project-grounding.md
protocol-contracts.md
specification-authorities.md
stack-guidelines.md
styling-systems.md
ui-components-and-tokens.md
usage.md
visual-direction-and-anti-slop.md
scripts/
validate-frontend-visual-evidence.py

详细介绍

前端实现

入口门槛

在现有技术栈中实现获准的最小前端范围。阅读有效指导、当前 Worktree、目标路由/组件,以及仅适用的产品/UI/设计规范。若关键行为或视觉契约尚未明确,则停止。

路由图

请求条件阅读内容结果
任何前端源代码变更checklist 的适用章节优先复用的实现
工具链、依赖、路由、技术栈迁移或渲染/副作用语义变更stack guidelines 的相关章节技术栈特定约束
框架状态、生命周期、路由或组件 API 语义变更选定的 framework profile兼容框架的变更
确认无操作或接受基线checklist精确的所有者符号和基线检查证据
涉及行为/公共接口、所有权或质量问题behavior first、codebase design 和/或 code quality限定范围的设计/验证
被修改的文件、组件或函数混合了相互独立的 UI、状态、数据、副作用或业务职责decomposition职责统一的所有者和清晰易读的编排
样式系统或 CSS 所有权变更针对变更涉及的问题,参阅 styling systems 或 CSS governance限定范围的样式处理
共享组件/令牌或布局所有权变更components/tokens 或 layout适用的视觉契约
动画或视觉方向变更motion 或 visual direction适用的交互/视觉契约
涉及选定源代码的视觉验收specification authorities 和 visual evidence运行时对比边界
涉及 API/协议或跨边界信号OpenAPI governance、protocol contracts 和/或 project grounding经核实的集成工作

不变量

  • 创建新内容前,优先复用最近且仍受维护的所有者;保留路由、状态/数据、组件和样式的所有权。
  • 将规模视为审查信号,而非行数规则;仅在稳定的所有权、行为、生命周期、副作用或验证边界处拆分。
  • 确认无操作时,仍须读取并报告确切的所有者路径和符号,以及与之匹配的契约,然后再运行当前基线的定向检查。
  • 使用成本最低且最贴近变更行为的证据:源代码/差异检查、已运行且支持热重载的开发界面、定向测试,最后仅在其边界或交付阶段有要求时进行完整生产构建。
  • 保持产品行为与 UI 视觉就绪状态相互独立;源代码/构建证据不能证明浏览器/客户端/运行时验收已通过。
  • 不生成视觉资源,不操作浏览器/客户端状态,不进行审查,也不修改 Git。
  • 将本阶段的证据交给协调方,由其通过相应所有者继续执行已获授权的运行时验收、修复和交付。仅切换所有者既不需要新任务/子代理,也不需要重新审批。

输出图

在适用时,分别报告范围、规范依据、复用决策、选定配置、变更文件/契约、定向验证、开发界面证据和生产构建状态,并说明排除项与缺口。

参考地图

  • 仅阅读适用的检查清单章节,了解基线实现;使用路线图了解技术栈和框架详情。
  • 仅在适用条件满足时,加载路线图中指定的每个特定条件参考资料。
  • 仅在构建视觉证据时,阅读前端视觉门禁示例。
  • 阅读用法,了解触发条件和边界。
  • 仅限维护人员:阅读评估用例;常规运行期间不要加载。

评论

支持 Markdown