Agent Skills
› b-editor/beutl
b-editor/beutl
GitHub用于获取或生成符合版权规范的媒体素材（图片、视频、音频、字体），涵盖来源筛选、许可证校验及下载入库，确保合规性。
Install All Skills
npx skills add b-editor/beutl --all -g -y
Skills in Collection (31)
用于获取或生成符合版权规范的媒体素材（图片、视频、音频、字体），涵盖来源筛选、许可证校验及下载入库，确保合规性。
需要获取工作区中不存在的照片、视频片段、音乐或音效
需要为项目引入外部字体资源
需要生成无版权风险的程序化纹理或矢量图形
npx skills add b-editor/beutl --skill beutl-agent-asset-sourcing -g -y
将简短的视频需求或参考媒体扩展为完整的制作简报，确保创意发散并记录推导依据，为后续时间线规划做准备。
视频请求过于简略，缺失关键细节
用户提供了描述预期效果的参考图片或视频
npx skills add b-editor/beutl --skill beutl-agent-brief-expansion -g -y
指导Agent通过MCP工具为Beutl元素应用一致的视觉效果链。涵盖色彩推导、调色板生成、背景语法规划及源码 grounding，确保视觉风格符合创意方向与约束。
需要统一或批量修改Beutl元素的视觉风格
涉及颜色、阴影、模糊等效果链的配置与应用
需要基于特定创意方向进行色彩和材质设计
npx skills add b-editor/beutl --skill beutl-agent-look-effect-chain -g -y
用于 Beutl Agent 编辑前的源码验证，确保 MCP 编辑符合运行时语义（如坐标、变换、布局），通过读取源码和测试生成 grounding 笔记以保障编辑准确性。
MCP 编辑依赖坐标或变换参数
渲染输出与编辑假设冲突
npx skills add b-editor/beutl --skill beutl-agent-source-grounding -g -y
将镜头列表或分镜脚本转化为 Beutl 项目时间线。通过 Agent Editing Toolkit MCP 工具，按视频类型分类、静态分镜构建、特效与动画添加等阶段自动化生成视频工程。
用户需要将镜头列表转化为视频项目
用户需要根据分镜脚本生成时间线
用户需要基于定时简报创建 Beutl 项目
npx skills add b-editor/beutl --skill beutl-agent-timeline-from-shotlist -g -y
用于对Beutl Agent渲染的静帧和故事板进行视觉质量审查，基于六维评分标准评估色彩、排版、构图等，并转化为具体的编辑指令。
需要审查渲染后的静帧或故事板接触表时
协调员要求进行美学质量反馈时
npx skills add b-editor/beutl --skill beutl-agent-visual-review -g -y
自动检查 AI 工作流配置文件与代码库状态的一致性，识别过时引用并提出改进建议。适用于完成重大任务或用户要求审查 AI 设置时，确保 AI 配置不偏离实际项目结构。
完成包含3个以上文件变更的任务后
用户输入'review the AI setup'、'self-review'或'AI設定を見直して'时
npx skills add b-editor/beutl --skill beutl-ai-self-review -g -y
从GitHub Project #9任务板选取待办事项，验证有效性后规划、实现、测试并创建PR。若为误报则标记状态。适用于自动化处理代码审查发现或手动添加的任务项。
ボードからタスクを選んで作業して
projects/9 のタスクをやって
pick a task from the board
consume a backlog item
npx skills add b-editor/beutl --skill beutl-board-task -g -y
用于构建和编译 Beutl 解决方案或特定项目。支持全量、单项目或生成器构建，自动确认范围并执行 dotnet build，失败时报告错误代码并停止等待指令。
用户要求构建、编译或检查代码是否通过
包含 'ビルドして', 'build', 'コンパイル通る?', 'this still compiles?' 等关键词
npx skills add b-editor/beutl --skill beutl-build -g -y
生成 Beutl 代码覆盖率 HTML 报告，用于评估模块测试完备性。支持全解决方案或单项目范围，自动收集并合并覆盖率数据，确保本地与 CI 结果一致。
用户询问测试覆盖率情况
请求生成覆盖率报告
想知道某模块是否经过充分测试
npx skills add b-editor/beutl --skill beutl-coverage -g -y
提供 Beutl 框架中自定义 Drawable 对象的实现指南，涵盖核心与扩展包的代码结构、属性定义及绘制逻辑。
create a Drawable
implement a drawable object
add an element like SourceImage/Shape/TextBlock
npx skills add b-editor/beutl --skill beutl-drawable -g -y
Beutl框架FilterEffect实现指南，指导创建模糊、色彩校正等图像滤镜效果。涵盖类定义、可动画/静态属性配置及Shader集成步骤。
create a FilterEffect
implement a new effect
add a filter
Beutl effect dev
SKSL
GLSL effect
npx skills add b-editor/beutl --skill beutl-filter-effect -g -y
用于对 Beutl 解决方案运行 dotnet format，支持验证或应用代码格式与风格检查。需确认范围和模式，自动匹配 CI 规则，不手动修改样式，格式化后生成变更摘要但不自动提交。
用户请求格式化代码
检查代码风格
修复 lint 错误
npx skills add b-editor/beutl --skill beutl-format -g -y
在提交PR前本地运行代码格式、构建及GPL/MIT合规扫描，模拟CI流程以快速反馈问题。
PR出す前に確認
pre-PR check
ready to push?
before I open the PR
npx skills add b-editor/beutl --skill beutl-pre-pr -g -y
自动生成一次性 Beutl 测试项目，用于手动验证渲染管线和滤镜效果。通过临时目录构建控制台应用生成项目文件，支持自定义输出路径、分辨率及元素类型，执行后自动清理，适用于创建测试数据或视觉冒烟测试。
用户要求创建测试项目
需要生成测试数据
请求日语测试项目相关指令
需要对渲染管线进行可视化冒烟测试
npx skills add b-editor/beutl --skill beutl-test-project -g -y
运行 Beutl 项目的 NUnit 测试套件，支持全量、单项目或按名称过滤。执行前需确认范围以避免耗时，失败时报告错误详情并等待指令。
用户要求运行测试
验证修复结果
复现失败用例
检查模块覆盖率
npx skills add b-editor/beutl --skill beutl-test -g -y
提供 Beutl 编辑器 ToolTabExtension 的实现指南，涵盖 MVVM 模式下的扩展点注册、ViewModel 绑定及 UI 控件创建，用于添加可停靠的工具标签页。
需要添加自定义工具标签页
实现 ToolTabExtension 或 IToolContext
npx skills add b-editor/beutl --skill beutl-tooltab-extension -g -y
在任务生成后，对spec、plan和tasks文档进行跨工件的一致性、质量和合规性分析。严格只读，识别不一致项并生成报告或修复建议，确保符合项目宪法。
需要检查规格、计划和任务文档的一致性时
实现前验证文档质量与合规性时
npx skills add b-editor/beutl --skill speckit-analyze -g -y
根据用户输入生成需求规格说明书的质量检查清单，验证需求的完整性、清晰度和一致性，而非代码测试。支持通过配置文件扩展前置钩子。
需要评估需求文档质量
生成需求检查清单
验证需求规格完整性
npx skills add b-editor/beutl --skill speckit-checklist -g -y
通过提出最多5个精准问题识别功能规格中的模糊或缺失点，并将答案编码回规格文件。支持扩展钩子检查与前置执行，旨在减少歧义，为后续规划阶段提供清晰依据。
需要澄清功能规格细节时
在制定实施计划前完善需求定义
npx skills add b-editor/beutl --skill speckit-clarify -g -y
根据用户输入或项目上下文创建/更新项目宪法文件，同步依赖模板并执行扩展钩子。
需要初始化或修改项目原则与规范时
调用 speckit-constitution 命令时
npx skills add b-editor/beutl --skill speckit-constitution -g -y
用于 Spec-Driven Development 流程中创建或切换至 speckit/<NNN>-<slug> 格式的功能分支。支持解析输入、预检工作区状态、分配特征编号并报告分支信息，确保分支命名规范与上下文一致。
用户需要为新功能创建 git 分支
切换到已有的 spec-kit 功能分支
执行 /speckit-git-branch 命令
npx skills add b-editor/beutl --skill speckit-git-branch -g -y
执行实现计划，处理并执行 tasks.md 中定义的所有任务。包含前置检查、扩展钩子调用及清单状态验证，确保开发流程规范执行。
需要执行具体的代码实现任务时
运行 speckit-implement 命令时
npx skills add b-editor/beutl --skill speckit-implement -g -y
执行实施规划工作流，通过模板生成设计工件。支持扩展钩子管理、上下文加载及多阶段规划（研究、数据模型、合同），确保符合宪法规范并输出最终计划报告。
需要制定软件功能实施计划时
生成技术设计文档和架构规范时
npx skills add b-editor/beutl --skill speckit-plan -g -y
根据自然语言描述创建或更新功能规格说明书。支持读取扩展钩子配置，执行前置检查与命令，生成简洁的功能名称及分支信息，用于规范需求定义流程。
用户输入功能描述以 `/speckit-specify` 开头
需要为现有功能补充或修改规格文档
npx skills add b-editor/beutl --skill speckit-specify -g -y
基于设计工件生成按依赖排序的可执行任务列表。支持读取plan、spec等文档，自动处理扩展钩子，并按用户故事优先级组织开发任务。
需要生成功能开发任务清单
根据设计文档拆解开发步骤
npx skills add b-editor/beutl --skill speckit-tasks -g -y
将现有任务转换为依赖有序的 GitHub Issue，支持前置/后置扩展钩子执行。
用户要求将任务转化为 GitHub Issue
需要基于设计文档生成可执行的 Issue
npx skills add b-editor/beutl --skill speckit-taskstoissues -g -y
用于在CI Linux环境中复现和根因分析SwiftShader GPU原生崩溃（SIGSEGV）。通过ARM64 Docker容器捕获核心转储、生成原生堆栈及文件追踪，解决本地无法复现的问题。
CI中GPU测试出现原生崩溃且无托管堆栈
用户要求复现SwiftShader/Vulkan相关崩溃
需要获取原生调用堆栈或核心转储
npx skills add b-editor/beutl --skill beutl-gpu-crash-repro -g -y
自动循环处理项目看板任务，通过调度子代理实现代码、发起PR、解决Bot审查并合并低风险PR，旨在高效清理积压工作。
用户指令包含'ボードをループで消化して'
用户指令包含'loop the board'
用户指令包含'keep working AI-review items until …'
用户调用命令'/beutl-loop'
npx skills add b-editor/beutl --skill beutl-loop -g -y
用于处理PR代码审查，自动或交互式地收集评论、判断是否需要修改并解决线程。支持人类确认和自主模式，适用于响应PR审查反馈的场景。
用户要求处理PR审查意见
需要自动或手动解决代码审查线程
npx skills add b-editor/beutl --skill beutl-resolve-reviews -g -y
自动化将 Spec-Kit 各阶段生成的文档工件按规范提交为 Conventional Commit，支持手动触发与钩子调用，兼容双路径并处理多文件合并及歧义检测。
执行 /speckit-git-commit 命令
Spec-Kit 工作流钩子 after_specify/after_plan/after_tasks 触发
npx skills add b-editor/beutl --skill speckit-git-commit -g -y
