技能构建指南
指导创建可复用、可触发且易维护的 Agent Skill。
内容主要提供技能创建指导,未见恶意行为、凭证窃取或隐蔽外传;脚本涉及创建目录、写文件和打包,但未规定最小权限、用户确认、敏感数据处理、回滚或数据流披露,因此扣分。仓库提供Apache-2.0许可和官方组织来源,但技能自身仅引用LICENSE.txt,归属与许可落地仍不完整。
结构和流程大体自洽,包含初始化、编辑、打包和迭代路径;但依赖PyYAML未声明,脚本未提供测试,关键路径和异常输入缺少诊断性反馈,且静态审查不能证明可运行,因此限制在10分以内并扣分。
描述明确面向创建或更新Claude技能,正文覆盖资源类型、触发描述和典型工作流;但未充分定义不适用场景、环境要求、中文支持或语义误触发边界,扣分。
信息架构清晰,使用渐进披露并提供references链接、示例和资源组织说明;但缺少版本、变更记录、维护责任、更新路径、安装依赖和系统化故障排查,且LICENSE.txt引用存在不确定性,因此扣分。
对于指导技能设计和打包的核心任务,内容直接可用,涵盖流程、模板和示例;但没有代表性产出、用户反馈或执行验证,实际结果完整性和相对手工方案的收益证据不足,按静态校准不超过7分。
文件包含可审计的流程、脚本和仓库CI配置,但CI主要验证插件而非该技能的关键行为,未见提交测试套件、第三方复现或多源交叉证据;静态审查下给予上限5分。
- 这是低置信度静态审查,未执行脚本或验证打包结果。
- 使用前应确认PyYAML等依赖可用,并补充针对初始化、验证和打包关键路径的测试。
- 脚本会写入文件和创建目录;在受限或生产环境中应先确认目标路径、权限和覆盖行为。
- 应明确LICENSE.txt的实际位置、维护责任、版本策略和更新渠道,并补充中文用户与网络环境适配说明。
它能做什么 & 适用场景
这是 financial-analysis 插件中的 skill-creator,用于指导用户创建或更新可扩展 Claude 能力的技能。它说明如何设计 SKILL.md、编排 scripts、references 和 assets,并通过渐进式披露控制上下文占用。内容覆盖需求理解、资源规划、初始化、编辑、打包和迭代。它适合需要建立自定义技能工作流的开发者,但不是面向终端用户的现成业务技能。
指导使用具体示例明确技能用途和触发场景;规划可复用的脚本、参考资料和资源文件;建议通过 scripts/init_skill.py 初始化新技能;指导编写仅含 name 和 description 的 YAML frontmatter 及正文;建议使用 scripts/package_skill.py 验证并打包 .skill 文件;说明如何根据实际使用结果迭代技能。
- 开发者需要为特定领域创建一个新的 Agent Skill,并先梳理真实使用示例。
- 团队希望把重复编写的脚本、API 文档或模板整理为可复用技能资源。
- 维护者需要检查技能的触发描述、目录结构和资源引用是否适合分阶段加载。
- 技能作者完成编辑后,需要验证并生成可分发的 .skill 包。
- 已有技能在实际使用中表现不佳,需要根据问题迭代 SKILL.md 或配套资源。
优缺点一览
- 覆盖从需求理解到打包迭代的完整技能创建流程。
- 明确强调简洁性、触发描述质量和渐进式披露。
- 同时说明脚本、参考资料和资源文件的适用场景。
- 内容主要是方法指南,不提供面向特定业务领域的现成技能功能。
- 供给材料未展示该技能的专属测试套件或独立运行示例。
- 打包和初始化依赖仓库中提供的 Python 脚本及文件系统访问。
如何安装
该技能位于仓库的 plugins/vertical-plugins/financial-analysis/skills/skill-creator/SKILL.md。README 提供的 Claude Code 安装方式是:先执行 claude plugin marketplace add anthropics/financial-services,再执行 claude plugin install financial-analysis@claude-for-financial-services。源码没有提供单独安装此技能的命令。
如何使用
在已加载该技能的环境中提出创建或更新技能的请求,例如“创建一个用于处理 PDF 的新技能,包含脚本、参考资料和模板”。创建流程可使用 scripts/init_skill.py <skill-name> --path <output-directory> 初始化,并在完成后使用 scripts/package_skill.py <path/to/skill-folder> 打包;命令应在包含这些脚本的仓库环境中执行。具体自动触发行为取决于宿主客户端。