1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | functional-skill-creator（技能内部命令名 fskill-creator） |
— |
| 作者/维护者 | AGI-comming（GitHub 组织），主要开发者 JiaweiWuInShopee | GitHub API |
| 来源链接 | https://github.com/AGI-comming/functional-skill-creator | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars / Forks | 462 / 26 | GitHub API |
| 最新版本 | v0.1.0（package.json） | 仓库文件 |
| 安装方式 | npx skills add AGI-comming/functional-skill-creator --skill fskill-creator -y（经 skills.sh 安装器） |
仓库文档 |
项目自述名称与正式名称一致（大小写与空格差异不计），均为 functional-skill-creator。
2. 功能介绍与亮点
functional-skill-creator（内部命令 fskill-creator）是一个专门用来重构和维护其他 Agent Skill 的元技能：把逐渐膨胀成“一堆规则+补丁”的长文本 SKILL.md，按函数式编程思路拆解成一组带明确输入/输出契约的 Function，SKILL.md 只负责编排这些函数的流程，跨函数共享的规则单独放进 references/，确定性的解析/格式化/校验逻辑落到 scripts/。
两条主路径：/fskill-creator create <workflow> 从需求描述直接生成新的功能化 skill；/fskill-creator migrate <path> 把已有的旧式 skill 目录（含 SKILL.md、references、scripts 等全部文件）整体迁移为功能化结构。每个 Function 都可配备单元测试与端到端用例，并内置本地运行追踪（记录输入/输出快照、耗时、token 估算），默认完全离线，且对疑似密钥字段自动打码。
亮点：零外部运行时依赖（package-lock.json 仅含自身一个包）；仓库含 CI 工作流、SECURITY.md、CONTRIBUTING.md 与含实测用例的完整示例目录；README 提供中英双语版本。
3. 适用场景
固定分类：元技能与 Agent 增强
- 自定义 Claude Code 技能随迭代不断打补丁、SKILL.md 越写越长、担心某次改动悄悄破坏旧功能却无从察觉的开发者
- 想把一份“能跑但不好维护”的旧 skill 目录，转换成可逐函数单测、可追踪运行记录的模块化结构的维护者
- 团队协作维护同一批 skill、需要明确的函数级输入输出契约以降低多人修改冲突的场景
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 ✅ | SKILL.md 采用 Claude Code 官方技能格式；skills.sh 安装器明确列出 Claude Code 为支持平台 |
| Codex | 需适配 ⚠️ | skills.sh 安装器明确列出 Codex 为支持平台，可用 -a codex 定向安装；项目自身声明“不绑定任何特定 agent 平台” |
| OpenClaw | 未验证 ❓ | 抓取材料中未见明确提及 |
| Hermes Agent | 未验证 ❓ | skills.sh 支持列表含 Nous Research（Hermes 系列模型发行方），但未见对 Hermes Agent 运行时本身的直接确认说明 |
5. 推荐理由
用函数化拆解和单元测试，为膨胀的SKILL.md提供可持续维护的工程方法
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 462 stars，处于 200–1k 区间；仓库创建约 5 周内自然增长，GitHub Issue 中有真实外部用户互动，但未发现第三方媒体或社区的独立讨论 |
| 可用性 | 9 | 一条 npx skills add 命令即装；docs/ 目录五份分主题文档 + 完整可运行示例；零外部依赖；最近一次代码推送为 2026-06-29 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合评分 | 7.7 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行 | 有，均为本地 Node.js 脚本（lint/test/migrate 辅助），仅读写目标 skill 目录内文件，未见 child_process 或任意外部 shell 调用 |
| ② 运行时联网外发 | 默认关闭（report_mode 默认为 off）；仅当用户显式切换为 remote 模式并自行配置上报地址时，才会通过 fetch 上传运行记录，且内置疑似密钥字段自动打码与长度/深度截断 |
| ③ API key/凭据 | 不要求任何凭据；可选远程上报的目标地址由用户自行配置，非项目预置 |
| ④ 可疑指令 | SKILL.md 与全部脚本内容中未见提示词注入或隐藏指令 |
| ⑤ 作者信誉 | 主要开发者账号注册于 2025-07-23、23 名关注者、任职 Shopee；对用户提交的 issue 有实质回应并据反馈更新文档，无造假迹象 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护 | 最近一次代码推送 2026-06-29 |
安全性未给满分的原因：涉及本地脚本执行（lint/test/migrate），虽范围明确、全程可审计且默认无外联，仍落在“有代码执行但可审计”的 7–8 档，未达“纯提示词零执行”的满分档。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| skill-creator（Anthropic 官方） | 从需求访谈出发，从零创建 skill 并用“带/不带 skill”对照测试量化其有效性 | 解决“skill 有没有用”的验证问题，起点是空白需求；不处理已有臃肿 SKILL.md 的模块化重构 |
| SkillOpt（Microsoft Research） | 用带验证门控的自动文本编辑持续训练 skill.md，让技能随使用自我优化 | 关注“让技能文字变得更准”，通过训练闭环自动改写措辞；不改变 skill 的文件/函数结构 |
| Skill_Seekers（yusufkaraaslan） | 把外部文档站点、GitHub 仓库、PDF 等批量转换生成新的 SKILL.md | 解决“从外部资料生成技能”的输入端问题；不涉及已有 skill 的架构重整 |
差异化：functional-skill-creator 的独特定位是“重构”——把已经写得又长又乱的 SKILL.md，按函数契约拆分成可逐个单测、可追踪运行记录的模块化单元，解决的是“skill 变复杂之后怎么继续维护”，而不是“从零创建”（skill-creator）或“自动调优文字”（SkillOpt）。三者面向的是技能生命周期的不同阶段，可以组合使用而非互相替代。
8. 用户评价
GitHub Issue #1 中，用户 ketLieio 反馈用 /fskill-creator migrate 迁移旧 skill 后，函数间输入输出出现不匹配（lint_skill.mjs 只检查章节标题、不检查跨函数 I/O），询问这是否是 alpha 阶段的正常现象。维护者 JiaweiWuInShopee 回应确认：迁移过程本身会暴露原 skill 设计中已存在的输入输出边界模糊问题，这属于迁移工具的预期发现而非 bug，并据此在文档中新增“What Migration Surfaces”章节说明。该技能目前除此互动外，第三方平台尚无更多具名用户评价。
9. 其他补充
package-lock.json 显示项目零外部依赖，仅用 Node.js 内置 --test 测试运行器。docs/ 目录含五份分主题文档（function-contract.md、functional-skill.md、observability.md、scripting.md、testing.md）及独立的中文版 README。examples/meeting-notes-to-actions/ 提供一个完整的“会议纪要转行动项”范例，包含 functions、references、scripts、testcases 全套目录结构，可直接参考模仿。
10. 安装使用方式
- 方式一（推荐）：
npx skills add AGI-comming/functional-skill-creator --skill fskill-creator -y，经由 skills.sh 安装器完成；可加-a <agent>定向到特定 Agent 平台，加-g做全局安装（需目标平台支持） - 方式二：手动克隆仓库
git clone https://github.com/AGI-comming/functional-skill-creator.git，复制skills/fskill-creator子目录到自己项目的 skill 目录 - 安装后无需重启；当用户提出“创建一个功能化 skill”或“把这个旧 skill 迁移成 functional skill 结构”等意图时会触发调用；create/migrate 两条路径都会先展示生成计划待用户确认后才写入文件；运行追踪功能默认关闭，需要时可通过环境变量开启本地或远程记录
11. 注意事项
- 单一开发者维护、创建约 5 周的年轻项目，issue 响应及时但生态规模尚小，长期可持续性有待观察
migrate功能目前仍处 alpha 阶段：据维护者对 Issue #1 的回复，迁移旧 skill 时可能暴露原 skill 本身的输入输出设计缺陷，需人工核查修正而非全自动完成- 与 Codex 的具体兼容程度仅基于 skills.sh 安装器的平台列表判断，未经第一方运行验证；OpenClaw 与 Hermes Agent 的兼容性均未验证