froQ 自己的 agent skills。froq- 前缀标记 froQ 个人工作流/环境类 skill,通用方法论 skill 不带前缀。正文和 description 一律英文。
0froq/skills 是 antfu/skills 的 fork。那边有生成器、git submodule,以及一整份上游文档镜像。pnpm start cleanup 会删掉任何没有写进 meta.ts manual 的目录,手写 skill 也必须套进那四类 taxonomy。这边没有生成器,也没有 meta.ts。加一份 skill 就是加一个目录。
Vue、Nuxt、Vite 等框架 skill 从各自的上游仓库装,不放在这里。第三方手写 skill(humanizer、caveman、ponytail 等)也从上游装,不收进这个包。
pnpx skills add 0froq/skills-pack --skill='*'只装一份:
pnpx skills add 0froq/skills-pack --skill=froq-stack| Skill | |
|---|---|
| froq-workbench | 环境规范:mo/mise/cf、目录约定、Mini/Air、安全边界 |
| froq-os-contrib | 单次开源贡献的执行:选 issue、两阶段修程、认领、上游权限边界 |
| froq-create-pr | 起草 PR 标题与描述:模板顺序、fallback 骨架、Fixes 规则 |
| froq-create-issue | 起草新 issue:模板、复现结构、查重 |
| froq-create-repo | 建 repo 的决策清单与形态路由 |
| froq-stack | 技术栈与配置:目录、runtime、lint/format、Nuxt、UnoCSS、catalogs、脚手架 |
| froq-web-app | web app 架构与 Cloudflare 发布 |
| froq-code-style | 编码规范:文件布局、types、测试、catalog、发布 |
| froq-longform | froQ 声音的长文/随笔 |
| froq-mailman | Fastmail 邮件(JMAP):读、搜、起草,默认不发送 |
| froq-design | 设计原则与 UI 审核标准 |
| whittle | 把开放设计问题收敛为 DAG 并清零 |
| external-copy-polish | 对外文案去 AI 味:标点、口吻、checklist |
| simplify | 把当前 diff 消融到最小正确版本 |
| froq-review | 审别人的 PR:意图 / 规范两轴,证据先行 |
| froq-explain | 向 froQ 解释:行为优先,深度跟问题走 |
在 skills/<name>/SKILL.md 写 frontmatter。个人工作流类用 froq- 前缀,通用方法论不带。Frontmatter 遵循 agentskills.io spec,正文结构按 TEMPLATE.md(固定节:定位段 + 领域节 + Boundaries + Hand-offs):
---
name: <dir-name>
description: <one line, matches body language>
license: MIT
metadata:
author: froQ
version: "0.1.0"
source: Hand-written. https://github.com/0froq/skills-pack
---正文骨架:一段定位(这层回答什么、不回答什么)→ 领域规则节(自由组织)→ ## Boundaries(硬性不做,没有就写 None)→ ## Hand-offs(委托给谁/被谁调用,没有就写 None)。When 和 References 可选。
metadata.version 是 semver:PATCH 修内容、MINOR 加章节、到 1.0.0 算稳定。需要拆开的说明放在同目录的 references/。可执行脚本放 scripts/。不要加生成脚本,也不要把上游文档镜像进来。
skill 之间平行原子化,靠引导指向串起来:
froq-create-repo ──→ froq-stack / froq-web-app / froq-code-style
froq-os-contrib ──→ froq-create-pr / froq-create-issue
froq-review ──→ simplify(自己的 diff)/ froq-os-contrib(贡献流程)
froq-explain ──→ external-copy-polish(对外文案)/ froq-create-pr(正文)
froq-os-contrib, froq-create-pr, froq-create-issue, froq-mailman
──→ external-copy-polish(对外草稿润色)
froq-stack ──→ froq-code-style / froq-web-app
froq-design ──→ @froq/ui(产品方向实现)
simplify ──→ froq-code-style
froq-longform ──→ external-copy-polish(转出,不再自带)