# skills

**Repository Path**: webthree/skills

## Basic Information

- **Project Name**: skills
- **Description**: AI 技能集合
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-30
- **Last Updated**: 2026-09-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Skills

前端组件相关的 Skill 集合。每个 Skill 一个目录，内含 `SKILL.md`（触发条件、规范、模板）与 `scripts/`、`assets/` 等配套资源；`SKILL.md` 的 frontmatter（`name` + `description`）决定它何时被触发，正文写规范、模板与验证流程。

## 目录结构

```
skills/
├── LICENSE                                    # 本仓库自研 skill 的 MIT 授权（署名见文件）
├── README.md
├── qy-html-component/                       # qy- 组件本体封装规范
│   └── SKILL.md
├── qy-doc-demo-page/                        # qy- 组件「文档 + 演示」页规范
│   ├── SKILL.md
│   ├── assets/doc-demo-template.html        # 十节结构骨架模板（含左侧章节导航，替换占位符）
│   └── scripts/verify-demo-page.cjs         # 演示页静态校验（E1–E7 / W1–W4）
├── bronya2-workpanel-dev/                   # Bronya2 项目总规范（风格 / 架构 / 双栈约定）
│   └── SKILL.md
├── bronya2-schema-version-migration/        # SQLite schema 版本号迁移流程
│   └── SKILL.md
├── bronya2-web-dualstack-run-and-verify/    # Web 双栈启动与路由 / CSS 验证
│   └── SKILL.md
├── bronya2-hover-action-list-rows/          # 悬停浮现操作按钮的紧凑列表行
│   └── SKILL.md
├── ponytail/                                # 第三方收录：懒资深工程师模式
│   ├── SKILL.md
│   └── LICENSE                              # 上游 MIT 原文，署名归原作者
└── simplify-codebase/                       # 第三方收录：偶发复杂度审计与收敛
    ├── SKILL.md
    └── LICENSE                              # 上游 MIT 原文，署名归原作者
```

Skill 之间互相引用：`bronya2-workpanel-dev` 是总规范，其余三个 bronya2 skill 各管一个横切场景并回指它；`qy-html-component` 管组件本体，`qy-doc-demo-page` 管组件的说明与演示页。

## 项目内 Skills

### qy- 组件系列

| Skill | 说明 |
|---|---|
| [`qy-html-component`](qy-html-component/SKILL.md) | 生成 `qy-` 前缀的封装 JS 组件。两种输出模式：文件分离（`qy-{name}.css` + `qy-{name}.js` + `index.html`，默认推荐）和单文件 HTML。规定了 IIFE+原型链封装、CSS 前缀隔离、flex 布局（禁 grid）、jQuery 统一调用、unpkg CDN、公共占位图等硬性规范。 |
| [`qy-doc-demo-page`](qy-doc-demo-page/SKILL.md) | 为 `qy-` 组件编写「文档 + 可运行演示」的 `index.html`：固定十节结构（功能说明 / 快速开始 / 数据入参 / Options / Methods 与状态 / 交互手势 / 外观定制 / 演示案例 / URL 自动化钩子 / 常见问题）+ 长页左侧章节导航（锚点一一对应、滚动高亮），配套静态校验脚本 `verify-demo-page.cjs` 与浏览器实测抓图流程。文档断言必须逐条指向源码。 |

两者分工：`qy-html-component` 管组件本体，`qy-doc-demo-page` 管组件的说明与演示页。

### bronya2 系列（Electron + Vue 工作面板）

| Skill | 说明 |
|---|---|
| [`bronya2-workpanel-dev`](bronya2-workpanel-dev/SKILL.md) | 项目总规范，写该项目任何代码前先读：编码风格贴现有代码（一致性优先于个人偏好）、第三方库优先不造轮子且禁用停止维护的库、Electron 端与 Web 端的技术选型边界、渲染层禁止直接用 Node/Electron API 一律走 `src/api/*` 双栈包装，外加 IPC / 服务端路由登记与样式 token 约定。 |
| [`bronya2-schema-version-migration`](bronya2-schema-version-migration/SKILL.md) | 改表结构的安全流程：先对真实库只读体检，确认 `CURRENT_SCHEMA_VERSION` 版本号没被已下线功能留下的幽灵高位行占用，再写幂等建表 + `PRAGMA table_info` 判列迁移并注册进 `initDatabase()` 事务序列，最后只读验证迁移确实执行。防的是 `no such table` / `database up to date, skipping init` 这类静默失败。 |
| [`bronya2-web-dualstack-run-and-verify`](bronya2-web-dualstack-run-and-verify/SKILL.md) | Web 联调必须同时起 vite + Express（`npm run dev:web-server`，只起 `dev:web` 会让 `/api/*` 全报 `ECONNREFUSED`），端口从后台任务输出读、不要写死；业务先用 `curl` 打 `/api` 路由验再看 UI；`browser-use` 截图报 `NATIVE_BROWSER_VIEWPORT_UNAVAILABLE` 时改用 DOM 几何与作用域样式断言；后台任务停止后要清残留的 vite/tsx 子进程。 |
| [`bronya2-hover-action-list-rows`](bronya2-hover-action-list-rows/SKILL.md) | 侧栏紧凑列表行的定型做法：无卡片边框、行与行贴合，状态只用 `rgba(var(--color-primary-rgb), …)` token 底色区分；行名靠**固定** `padding-right` 预留按钮宽度（按 hover 切换会让文字抖动），操作按钮组绝对定位落在预留区、靠 `opacity + pointer-events` 显隐；含 Element Plus 兄弟按钮 margin 复位的坑与数量徽标淡出。 |

## 推荐：第三方开源 Skills

下面两个上游仓库都是**多文件技能包**（ponytail 在 `skills/` 下有 6 个变体，simplify-codebase 另带 `references/`、`docs/`、`README.md` 等）。本仓库只收录其中的主 `SKILL.md`，且两者都做了**精简改写、非逐字副本**（详见下表「本地形态」）；上游仍在活跃更新，需要完整能力请从上游安装。**第三方技能属外部代码，启用前建议先审阅其 `SKILL.md`。**

| Skill | 上游 | 说明 |
|---|---|---|
| [`ponytail`](ponytail/SKILL.md) | [DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail) | 「懒资深工程师」模式，任何编码任务都可常驻启用，说 `stop ponytail` / `normal mode` 才关，有 `lite / full / ultra` 三档。核心是一个自上而下止损的阶梯：这东西需要存在吗（YAGNI）→ 仓库里是否已有同类实现 → 标准库能做吗 → 平台原生特性能覆盖吗（`<input type="date">` 优于日期选择库、CSS 优于 JS、DB 约束优于应用层校验）→ 已装依赖能解决吗 → 能一行写完吗 → 最后才是最小实现。并要求修 bug 打根因：改共享函数里的一处守卫，小过在每个调用点各加一行。上游安装：`npx skills add DietrichGebert/ponytail` |
| [`simplify-codebase`](simplify-codebase/SKILL.md) | [tt-a1i/simplify-codebase](https://github.com/tt-a1i/simplify-codebase) | 偶发复杂度审计与收敛：目标是降低代码库必须维持自洽的「概念与义务」数量，减行数只是佐证，一次运行的结论也可以是「现状已属必要」。先选权限模式——Survey 只读、产出排序后的证据，Change 需明确授权才动代码并验证存活契约；再选范围——Focused（点名某子系统/符号/重复）或 Broad（整仓分区）。删除可达能力、对外接口、存储表示或兼容路径被视为产品决策，须先说明后果并取得指示。不用于通用 code review、风格性重构或性能调优。上游安装：`npx skills add tt-a1i/simplify-codebase` |

## 许可与出处

本仓库的授权分两层，请勿混同：

- **根目录 [`LICENSE`](LICENSE)**：MIT，署名 `Copyright (c) 2026-present SystemLight`。**仅覆盖本项目自研的 skill**（`qy-*`、`bronya2-*`）。
- **`ponytail/` 与 `simplify-codebase/`**：第三方收录件，著作权与署名归**原作者**，按各自上游的 MIT 分发，许可全文已随目录保留在 `<skill>/LICENSE`。这两份上游 MIT 的署名与本仓库根 LICENSE 相互独立，再分发时需一并保留。

| 目录 | 上游仓库 | License | 抓取时的 HEAD commit | 本地形态 |
|---|---|---|---|---|
| `ponytail/` | [DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail) | MIT © 2026 DietrichGebert | `e3ba2aa6f1e6` (2026-09-14) | `SKILL.md` 为**压缩改写版**（上游是多文件 skill 包，此处压成单文件），非逐字副本 |
| `simplify-codebase/` | [tt-a1i/simplify-codebase](https://github.com/tt-a1i/simplify-codebase) | MIT © 2026 simplify-codebase contributors | `5da55efcb52d` (2026-09-04) | 上游主 `SKILL.md` 为 96 行并带 `references/` 等附属文件，本地 81 行为**精简改写版** |

MIT 是宽松协议：允许商用、修改与闭源再分发，不传染本仓库其余代码，也不要求你把自研 skill 开源；唯一硬性义务就是上述「保留原作者许可全文与版权声明」。日后若从上游同步更新，请同步替换对应 `LICENSE` 并更新本表的 commit 号。