| name | drifox-dev |
| description | DriFox 项目专用开发技能。当你需要在 DriFox 项目中进行任何开发工作时（功能开发、Bug 修复、UI 组件开发、架构分析、插件/Skill/Agent 开发、代码审查、重构优化），必须首先加载本技能。本技能把固定规范放在 references/ 子文件、按需加载，根据任务类型把「新增功能」分派给 brainstorming、把「Bug/回归」分派给 diagnose，并把项目实时状态（git 快照 + GitHub open issues）缓存到 state.json 跨会话复用。即使看起来简单的改动也应该加载此技能——DriFox 架构复杂、模块依赖多，不加载容易违反项目约定。 |
DriFox 开发技能（drifox-dev · 有状态 · 渐进式披露）
本技能是有状态的。加载时先读 state.json 摘要，再按任务类型分派到 references/ 下的对应文件。
目的：减少首屏 token 占用，避免一次性把 480+ 行规范塞进上下文。
0. 加载流程（开局必做）
┌──────────────────────────────────────────────────────────┐
│ Step 1 读 state.json 摘要 │
│ → python scripts/state_manager.py show --summary │
│ → 解析输出（焦点 / 偏好 / 坑点 / 决策 / 项目快照 / │
│ GitHub open issues） │
├──────────────────────────────────────────────────────────┤
│ Step 2 按 §1 决策树分派到 references 下的具体文件 │
│ → 只读你这一步真正需要的文件，不要全读 │
├──────────────────────────────────────────────────────────┤
│ Step 3 模糊项目事实 → 看 state.json.auto_snapshot │
│ → 想看 GitHub issue → snapshot.github_issues │
│ → 想看实时行数 → snapshot.key_files_lines │
├──────────────────────────────────────────────────────────┤
│ Step 4 推进过程中持续更新 state.json（focus / pitfall / │
│ decision / snapshot） │
└──────────────────────────────────────────────────────────┘
1. 任务分派决策树（强制，每条任务必须先走这里）
读懂用户意图后，按下表选路径。默认就高不迭低：用户任务同时含新增 + 修 Bug，先 brainstorm 再 diagnose。
| 用户说 | 任务类型 | 第一步 | 必读 references |
|---|
| 加功能 / 做新东西 / 设计某某 | 新功能 | brainstorming 技能 | scenarios.md § 一 |
| 改架构 / 拆分模块 / 重命名 | 新功能 | brainstorming 技能 | scenarios.md § 五 |
| 不工作 / 报错 / 挂了 / 卡 / 崩溃 / 回归 | Bug | diagnose 技能 | scenarios.md § 二 |
| 性能变慢 / 内存涨 | Bug | diagnose 技能 | scenarios.md § 二 |
| 加 UI / 卡片 / 主题 | UI 改动 | 直读 dev-ui.md + architecture.md | UI 流程 |
| 加 Agent / 改 Skill / 写插件 | Agent/Skill | 直读 dev-agent-skill.md | 组件流程 |
| 加工具 / 调权限 / 改 Hook | 工具层 | 直读 dev-tools-hooks.md | 工具流程 |
| 跑测试 / 打包 / 提 PR | 工程化 | 直读 testing-build.md | 工程流程 |
| 定位要改的文件 / 看架构 | 查阅 | 直读 architecture.md | 全局 |
| 查 state / 改偏好 / 录决策 | 元操作 | 直读 state-reference.md | 元操作 |
| 命名 / 格式 / 提交规范 | 编码规范 | 直读 conventions.md | 编码规范 |
| 设计模式 / 多窗口 / 信号槽 | 模式 | 直读 patterns.md | 模式 |
| 其它（重构 / 优化 / 杂项） | 评估 | 按需加载 references | — |
⚠️ Bug 不走 brainstorming。diagnose 的第一阶段是「构造反馈循环」，脑子里还没想清楚前不要先碰代码。
⚠️ 新功能优先 brainstorm。即使用户说「很简单加个字段」，也走 1 问 → 给 2-3 方案 → 拿到批准这 3 步。
2. references/ 文件索引（按需加载）
唯一允许全量加载的文件是 SKILL.md 本体。以下内容仅在决策树指向它们时才读。
| 文件 | 何时读 |
|---|
references/architecture.md | 看架构 / 目录 / 后端信号时 |
references/patterns.md | 设计模式 / 多窗口隔离 / 热更新 / 信号槽时 |
references/conventions.md | 命名 / 风格 / 提交 / AGENTS.md 铁律时 |
references/dev-ui.md | UI 组件开发时 |
references/dev-agent-skill.md | 创建 Agent / 修改 Skill / 新插件时 |
references/dev-tools-hooks.md | 工具 / Hook / 权限系统时 |
references/scenarios.md | 走具体开发场景流程时（强烈推荐先读） |
references/testing-build.md | 测试 / 打包 / 提 PR 时 |
references/state-reference.md | state.json 字段 / CLI 用法时 |
3. 核心不变项（固定信息，所有任务都用）
| 项目 | 值 |
|---|
| 项目 | DriFox（飘狐） |
| 语言 / UI / 打包 | Python 3.14+ / PyQt5 + Fluent-Widgets / PyInstaller |
| 包管理 | uv（也支持 pip） |
| 当前分支 | dev |
| 仓库 | github.com/martin98-afk/DriFox |
| 工作目录 | D:/work/DriFox（项目根用相对路径） |
| 关键文档 | README.md、AGENTS.md |
上述信息是固定骨架的一部分；会变化的事实（关键文件行数、最近 commit、未提交变更、GitHub issues）都从 state.json.auto_snapshot 读——绝不手抄，会过期。
4. 与子技能的衔接
drifox-dev (本技能)
├─ 新功能 → 先 brainstorming
│ ↓ spec 通过
│ → writing-plans
│ ↓ 计划出来
│ → executing-plans / subagent-driven-development
│
├─ Bug / 回归 → 先 diagnose (6 阶段)
│ ↓ 定位完成
│ → tdd (回归测试)
│ ↓ 修复完成
│ → code-reviewer
│
└─ 元操作 → state-reference.md
5. 状态保鲜（最后一条）
每一次有意义的步骤后，调用 scripts/state_manager.py 更新 state：
focus --task "..." — 明确本轮任务pitfall --module X --symptom "..." --cause "..." --fix "..." — 踩坑立刻记decision --scope X --decision "..." --rationale "..." — 架构决策必留痕question [--blocking] --question "..." — 阻塞当前任务用 --blocking，否则默认非阻塞- 完成时
focus --clear
中途需要刷新快照（行数 / commits / GitHub issues）就 snapshot_project.py。
