SuperAPI AI 工具集

skill-architect

智能体与模型

查看项目

更新于 10-16 00:21

技能介绍

Skill Architect 从厂商中立视角架构可移植、高质量的智能体技能,可作为任何技能仓库或运行时的独立规划、创建、审查、重构、比较、提炼、对账与教学层。

用途:在设计技能、仓库标准、门禁、发布或迁移前规划;创建新技能或脚手架;按评分标准审计已有技能或技能仓库;应用可由 validate_skill.py 证明的确定性修复;在不改变用途的前提下重构;比较上游技能开发评分标准;从会话中提炼可复用技能;刷新过期的技能计划、审计、会话提炼提案或积压;解释技能编写标准或进行辅导。

模式:plan、create、audit、fix、refactor、compare、distill、reconcile、teach。若用户未指定模式,则推断最接近的模式并说明假设。audit 默认只读;fix 先 dry-run,仅对安全机械编辑执行 fix_skill.py --write,随后运行 validate_skill.py。

使用方式:先结合当前工作上下文,检查 CWD、项目文件、已安装技能位置或仓库约定;以 Agent Skills 规范为可移植基线语法,本地规则优先。按分类请求、读取本地标准、选择视角、运行可预测性检查、规划产物、窄改、机械验证的顺序操作。可移植核心放 SKILL.md 与链接引用,厂商细节放适配器或元数据。

辅助脚本位于 assets/scripts/:inspect_skill.py(汇总技能文件夹)、validate_skill.py(本地可移植技能校验)、fix_skill.py(保守确定性修复)、scaffold_skill.py(创建起始技能文件夹)、run_uv.py(清理继承的 UV_* 配置后启动 uv)。校验与检查需 Python >=3.10 及版本与哈希固定的依赖文件,须使用隔离运行器,切勿安装到全局环境。优先 uv,通过 run_uv.py 调用,并加 --isolated --no-project --no-build --no-config;不可用时回退到临时虚拟环境。

验证命令示例:npm run check:skill-standard、npm run check:drift、node bin/hash-check.mjs、npm test。

限制:外部评分标准只影响内容质量,本地规则在 frontmatter、清单、锁文件、CI 与发布门禁上优先。除非目标运行时与仓库 schema 都接受并执行,否则不要添加实验性 allowed-tools。inspect_skill.py 与 validate_skill.py 每次只接受一个技能文件夹,多技能需分别调用。某模式是否通过需以实际运行的测试为准,不能仅凭文本审查声称质量。部分细节(如具体定价、平台支持)暂未提供。