用途:为 Ping Identity 仓库编写可分发的插件技能,即 ./plugins/**/skills/ 下的技能文件,规范其结构、格式与内容。可与通用的技能编写技能配合使用。
主要能力与结构:从 assets/templates/SKILL.template.md 起步。默认每个领域一个技能,而非每个产品或每个活动一个,保持技能数量精简。SKILL.md 作为路由器,通过路由表按需从 references/ 文件逐层披露产品与活动细节。references/ 是直接维护的内容树,其中每个文件都会被发布并保持更新。
校验:任何改动后运行 python3 scripts/validate_skills.py --root .,该脚本校验技能 frontmatter 架构(description 长度 50–500 字符)、name 与目录一致、SKILL.md 不超过 160 行,以及行内 references/... 路由链接的可解析性。
规则:description 保持在 50–500 字符,它是每次会话中智能体路由的触发面,应包含高价值路由词(产品名、协议、错误字符串),去掉可推断内容。技能之间不得互相交叉链接作为交接,采用“智能体最清楚”的方式,不引用其他技能,由 frontmatter 的 description 承担路由职责。不得把工具调用(API、CLI、MCP、SDK)写进 SKILL.md 或 references;参考内容只写“是什么”和“为什么”,具体渠道做法分文件存放于 references/ 下的 api.md、cli.md、mcp.md、sdk.md。不要复制文档内容,技能假设客户环境具备 web_fetch,文档内容会漂移且造成上下文膨胀,每个参考文件以 ## Source 块链接实时文档,并声明实时文档优先。每个参考文件只涉及一个产品,避免混用导致幻觉。面向完全自主的智能体编写,不要出现“询问用户”“等待确认”等步骤,应给出具体下一步动作;面向人的澄清流程仅存在于 ping-identity-quickstart 技能。
打包:技能标识全部写在 SKILL.md frontmatter 中,包含 name、description、compatibility 及完整 metadata 块(publisher、version、product_family),没有按技能的 marketplace JSON 文件。重命名或调整范围时,需同步更新 frontmatter 与插件描述(.claude-plugin/plugin.json、marketplace 清单)。插件只发布内容,不捆绑评估程序、执行脚本或分类文件。
限制:具体产品与命令细节来自各技能自身,此处未提供;更详细的安装或使用步骤暂未提供。