‹ 首页

formax-skill-capture

@yusifeng · 收录于 5 天前 · 上游提交 3 周前

Use when we want to turn a just-finished Formax workflow (e.g. commands, overlays, tools, hooks, permissions, UI parity) into a reusable Codex Skill under .codex/skills, including scaffolding, guardrails, and the minimum test checklist.

适合你,如果你经常需要把Formax工作流封装成可复用的技能

/ 通过 npx 安装 校验哈希
npx oh-my-skill add yusifeng/formax/formax-skill-capture
/ 通过 bash 安装
curl -fsSL https://oh-my-skill.com/install.sh | bash -s -- yusifeng/formax/formax-skill-capture
/ 已经装过?验证本机副本,不用重装
npx oh-my-skill verify yusifeng/formax/formax-skill-capture
安装目标可用 --agent / --scope 或 --to 明确指定;省略时只会在唯一已存在的 agent 目录上自动选择,零命中或多命中会停止并提示。content_hash 缺失或不一致均拒装。
192GitHub stars
~493最小装载
~493含声明引用
~642文本包总量
索引托管

怎么用

商店整理自技能原文 · 版本 5a48573 · 表述以原文为准
它做什么

当完成一个Formax工作流后,Claude能将它自动转为.codex/skills下的可复用技能,包括文件映射、模式、测试清单和防护规则。

什么时候触发

当你说“把这个流程沉淀成skill”、“以后别再忘了怎么改/xxx”或“给我一个复用的修改清单/固定套路”时触发。

装好后可以这样说
Claude会询问技能名称、描述等信息。
Claude会生成对应的技能模板。
技能原文 SKILL.md作者撰写 · MIT · 5a48573

Formax skill capture (create skills from our workflow)

What this is

This skill is a Formax-specific wrapper around skill authoring: it helps us reliably convert “we just figured out how to do X” into a repo-local skill under .codex/skills/<skill-name>/.

It complements the built-in skill-creator (system skill) by adding Formax conventions:

  • repo-local skills (checked into git)
  • “where to change what” file map
  • invariants (UI parity, model injection orthogonality, etc.)
  • minimum regression tests to lock behavior
When to use

Trigger this when the user says:

  • “把这个流程沉淀成 skill”
  • “以后别再忘了怎么改 /xxx”
  • “给我一个复用的修改清单/固定套路”
Minimal questions to ask (do not proceed until answered)

1) Skill name (kebab-case), e.g. formax-slash-command-workflow 2) 1–2 sentence description: when should Codex use it? 3) Scope: which subsystem? (pick one)

  • slash commands / overlays
  • tools (spec/handler/presenter)
  • hooks
  • permissions/policy
  • stability/input routing

4) Any explicit “don’t change” constraints? (UI copy/spacing/colors, contracts, etc.)

Output requirements

The resulting skill must include:

  • a short “Goal” section
  • “Where to change what” (file list)
  • “Patterns” (2–4 common patterns)
  • “Tests to update” (minimum regression set)
  • “Guardrails” (what must not regress)

Avoid long prose; prefer checklists.

Create a new skill (scaffold)

Use the scaffold script:

bash .codex/skills/formax-skill-capture/scripts/new-skill.sh <skill-name> "<description>"

Then fill SKILL.md body with the content above.

Refactor policy for skills

When a skill is created from a workflow we already shipped:

  • Do not broaden scope (no extra features)
  • Do not rewrite UI (unless explicitly requested)
  • Write/extend tests first if behavior has regressed before
按 MIT 许可原样转载,未经改动 · 在 GitHub 查看 →

评论

登录即可评论;带「已验证安装」的,是发布者名下有本店的安装或持有记录。