Agent Skills
› Serial-Studio/Serial-Studio
Serial-Studio/Serial-Studio
GitHub专用于Serial Studio项目的Qt6/C++只读代码审查技能。结合确定性Linter与六路并行深度分析，覆盖模型契约、线程安全及性能等关键领域，仅报告高置信度问题，不修改代码。
安装全部 Skills
npx skills add Serial-Studio/Serial-Studio --all -g -y
集合内 Skills (15)
专用于Serial Studio项目的Qt6/C++只读代码审查技能。结合确定性Linter与六路并行深度分析，覆盖模型契约、线程安全及性能等关键领域，仅报告高置信度问题，不修改代码。
用户要求对C++代码进行review, audit, check, look over或sanity check
提交代码前建议进行审查
需要验证超出风格检查之外的Qt6/C++正确性
npx skills add Serial-Studio/Serial-Studio --skill qt-cpp-review -g -y
针对 Serial Studio 项目的 Qt6/QML 代码只读审查技能。通过运行确定性 linter 和六个并行分析代理，深入检测绑定循环、布局断裂等语义缺陷，仅报告高置信度问题而不修改代码。
审查 QML 代码
提交前检查 QML 变更
审计 QML 正确性
npx skills add Serial-Studio/Serial-Studio --skill qt-qml-review -g -y
用于审计Serial Studio AI相关文档与代码事实的一致性，发现并修复过时声明。通过自动化脚本和人工审查验证文件路径、符号等，确保文档准确性，仅修改文档不触碰代码。
要求审计技能或文档
检查文档是否存在漂移
验证CLAUDE.md是否仍准确
重构后需更新文档
npx skills add Serial-Studio/Serial-Studio --skill ss-ai-audit -g -y
规范 Serial Studio 数据热路径代码修改，涵盖帧处理、线程同步及零拷贝规则。用于在编辑或审查高吞吐量数据处理代码前强制开发者理解并遵守硬约束，防止静默丢帧和死锁。
需要修改或审查与 Driver 到 Dashboard 数据传输相关的代码
涉及 FrameReader, CircularBuffer, FrameBuilder, ConnectionManager 等核心组件的变更
npx skills add Serial-Studio/Serial-Studio --skill ss-hotpath -g -y
Serial Studio 工作流的第4阶段，负责执行已批准的 tasks.md。按顺序逐个完成任务，严格执行代码规范、验证及静态审查，确保变更符合计划且无新增错误，最终生成待提交记录。
任务列表已批准，需要开始编码实现
用户指令 'implement the spec' 或 'build it'
用户指令 'work the tasks'
npx skills add Serial-Studio/Serial-Studio --skill ss-implement -g -y
用于记录开发缺陷并推动自动化修复。当发现重复错误时，将其加入错误账本，分析原因，并评估是否可通过 lint、hook 或测试实现机械化拦截，从而防止同类问题再次发生。
要求记录此次错误
添加到常见错误列表
确保不再发生类似问题
维护者纠正了重复错误后
npx skills add Serial-Studio/Serial-Studio --skill ss-log-mistake -g -y
用于在 Serial Studio 项目中快速生成新的 I/O 驱动骨架代码。指导 Agent 遵循标准契约，实现 HAL_Driver 接口，并同步更新枚举、构建配置、连接管理器及 QML UI 等所有必要注册触点，确保新总线驱动正确集成。
添加新的数据源或总线支持
创建新的 I/O 驱动类
需要实现新的硬件通信协议
npx skills add Serial-Studio/Serial-Studio --skill ss-new-driver -g -y
将已批准的规格转化为具体技术设计文档，涵盖文件结构、数据流、线程影响及权衡分析。需读取架构与代码，遵循特定流程生成 plan.md，并在人类批准前作为任务拆分的前置步骤。
/ss-plan
plan this spec
design the implementation
npx skills add Serial-Studio/Serial-Studio --skill ss-plan -g -y
用于启动非平凡功能开发的需求规格制定技能。通过捕获功能的WHAT和WHY，生成结构化的需求文档，并执行前提检查，在实施前确保需求清晰且可验证，等待人工审批后进入规划阶段。
start a feature
spec this out
write a spec
npx skills add Serial-Studio/Serial-Studio --skill ss-spec -g -y
将已批准的计划分解为有序、可独立验证的任务清单。读取规范与计划，按依赖和范围拆分任务，明确文件、操作及验证方式，生成待审的tasks.md，不执行代码实现。
/ss-plan is approved
break this into tasks
task it out
npx skills add Serial-Studio/Serial-Studio --skill ss-tasks -g -y
提供代码风格检查与提交前清洗流程，涵盖 lint、格式化及自动化脚本生成。用于确保代码符合规范并满足 CI 门禁要求。
verify conventions
check code style
lint
run code-verify
sanitize the commit
npx skills add Serial-Studio/Serial-Studio --skill ss-verify -g -y
提供 Serial Studio C++ 编译器/链接器标志的指导，涵盖优化、加固、Sanitizers 及 mimalloc。用于解读 cmake 模块、调整编译参数或排查标志兼容性问题，不执行构建。
解释或调整 C++ 编译标志
分析 cmake 优化与加固配置
排查编译器标志兼容性
npx skills add Serial-Studio/Serial-Studio --skill cpp-compiler-flags -g -y
针对 Serial Studio 项目的 QML 编码规范，涵盖 Qt 6.11 最佳实践。指导代码编写、修复、重构及调试，强制执行 C++ 交互、主题、动画等内部约定，纠正 LLM 常见偏差。
需要编写新的 QML 界面组件
对现有 QML 文件进行错误修复或性能优化
重构 QML 代码以符合项目特定规范
排查 QML 绑定、布局或动画相关缺陷
npx skills add Serial-Studio/Serial-Studio --skill qt-qml -g -y
提供Serial Studio项目的现代C++20编码指导，涵盖智能指针、RAII、概念约束模板及热路径数据结构设计。旨在规范代码形态与所有权管理，不处理构建或测试流程。
编写非平凡的C++代码
重构现有C++模块
选择智能指针类型
设计RAII包装器
npx skills add Serial-Studio/Serial-Studio --skill ss-cpp-modern -g -y
用于编写、更新或审查 Serial Studio 的用户文档（如帮助手册和 README）。要求以代码为事实依据，遵循技术手册语气，并通过自动化脚本进行验证。
更新文档
撰写帮助条目
审查文档
编辑帮助内容
记录功能说明
npx skills add Serial-Studio/Serial-Studio --skill ss-docs -g -y
