关于 dev-frontend
dev-frontend 是一项用于在现有代码库中实施已授权前端改动的技能,强调优先复用、按需遵循设计与技术栈规范,并针对改动行为收集验证依据。
主要功能
- 01按适用规范处理改动
- 02优先复用维护中的组件与所有者
- 03按需选取框架和技术栈参考
- 04以低成本证据进行针对性验证
- 05报告范围、检查、排除项与缺口
适用场景
- 01在现有技术栈中实施前端改动
- 02依据所有者和契约核验无改动情形
- 03调整框架、路由或样式行为
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ idaibin/ skills --skill dev-frontend安装后在 Claude Code 中输入/dev-frontend确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlassets/frontend-visual-evidence.example.jsonfrontend-visual-evidence.schema.jsonreferences/behavior-first.mdchecklist.mdcode-quality.mdcodebase-design.mddecomposition.mdeval-cases.mdframework-profiles.mdfrontend-css-governance.mdfrontend-layout-governance.mdfrontend-visual-evidence.mdfrontend-visual-gate-example.mdinteraction-motion-quality.mdopenapi-contract-governance.mdproject-grounding.mdprotocol-contracts.mdspecification-authorities.mdstack-guidelines.mdstyling-systems.mdui-components-and-tokens.mdusage.mdvisual-direction-and-anti-slop.mdscripts/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