القائمة
BuSic主开发入口。用于功能开发、bug修复、代码重构时快速定位阅读顺序、执行顺序、最低验证和联动文档
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
BuSic数据层规范。用于Drift表定义、迁移、Repository实现和Domain模型映射时快速确认主真源与联动检查项
BuSic Git提交规范。用于整理提交范围、撰写约定式提交信息、选择安全Git操作并对齐当前main分支事实
BuSic代理执行工作流兼容层。用于自动化代理在当前仓库中执行任务时统一进度同步、风险确认、验证收尾和文档回写节奏
BuSic发布流程规范。用于执行正式发布时快速定位发布真源、推荐脚本、发布前检查项和最容易遗漏的manifest与资产联动
BuSic Skills维护规范。用于维护和重构.agents/skills时统一目录结构、模板、更新时机、自检方式和与docs的职责边界
BuSic状态管理规范。用于Riverpod codegen、Notifier编排、依赖注入和AutoDispose生命周期控制时快速查阅
| name | busic-main-workflow |
| description | BuSic主开发入口。用于功能开发、bug修复、代码重构时快速定位阅读顺序、执行顺序、最低验证和联动文档 |
| license | MIT |
| compatibility | opencode |
docs/20-workflows/dev-workflow.mddocs/00-start-here/agent-quickstart.mddocs/10-project/project-overview.mddocs/10-project/project-specific-rules.mddocs/30-reference/source-of-truth.md如果改的是特化系统，再补读：
docs/10-project/update-system.mddocs/10-project/subtitle-and-lyrics.mddocs/10-project/share-and-backup.mddocs/10-project/ui-and-platform-quirks.mddocs/10-project/bilibili-integration.mddocs/10-project/bilibili-integration.md（视频互动端点、登录态失败模式、收藏/投币/分享注意事项）docs/40-feature-plans/ 建规划文档@riverpod、@freezed、Drift 或 ARB 后，补 build_runner / gen-l10ndocs/ 与 .agents/skills/flutter analyze
flutter test
Agent 执行时，flutter ... 通常需要提权到沙箱外；完整分类见 busic-harness-workflow。
如果改了 codegen 或 i18n：
dart run build_runner build
flutter gen-l10n
dart run ... 与 flutter gen-l10n 在 agent 沙箱中也按通常需提权处理。
如果改动有平台或高风险联动，再补最小手测：
flutter run -d windows
flutter run -d <device_id>
app_database.dart、表定义、迁移和 Repository 映射songs.localPath 与 songs.audioQuality 的反向回写没有断bvid + cid 作为跨设备身份，不要带本地路径versions-manifest.json、app_update feature、Release 资产名VideoInteractionNotifier 的乐观更新回滚逻辑，点赞/投币/收藏状态读取失败时按未激活处理，写接口需要 bili_jct 作为 csrfdocs/，不要把新知识继续埋到归档文档busic-git-commit 整理提交