SuperAPI AI 工具集

plsql-skill-author

数据与分析

查看项目

更新于 10-16 06:14

技能介绍

该技能用于把开发者自己的做事方式固化成一个新技能,适用于“为我们的某种做法建一个技能”、沉淀团队约定或偏好等场景。开始时需说明正在使用 plsql-skill-author。

用途与流程:技能被视为“被记录下来、无需再争论的决策”,要写团队实际做法并附数据库证据,而非凭记忆。步骤一为一次一问的访谈:这个技能针对什么任务(一个关注点一个技能);何时触发(收集开发者会真实输入的短语,原样写入 description);哪些是硬性规则、哪些是偏好(硬规则给 Iron Law 与红旗表,偏好给“默认除非另有说明”);出错是什么样子(用过往事故做红旗表行)。步骤二为取证:先运行 pythia similar <TYPICAL_NAME> 找到体现该流程的程序族,用 pythia src 打开靠前结果,提取真实命名、参数与结构约定;用 pythia args / pythia cols 获取签名与类型;保存两三个简短原文片段作示例。步骤三按团队格式起草:frontmatter 用 kebab-case 名称并与文件夹一致,description 以触发条件(Use when ...)开头并含步骤一收集的短语;正文预算约 150 行,模板、清单、片段库等长材料放 reference/ 并链接;结构菜单按需选用 Iron Law、编号流程、红旗表、When NOT to use、开头宣告行。步骤四放置:用户技能放在开发者项目中,如 Claude Code 的 .claude/skills/<name>/SKILL.md(其他 agent 可用 skills/<name>/SKILL.md 布局配合 npx skills add);不要写入已安装的 pythia 包。步骤五验证触发:在新会话中用开发者真实说法提出任务,技能应自动激活,否则修改 description。

维护与限制:同一纠正出现两次时应考虑并入技能,过时规则要退役。对外分享前做卫生检查,确保技能与引用中不含主机、schema 名、凭据或内部标识。红旗提示包括不要凭聊天记忆撰写、不要做一个覆盖一切的大技能、不要粘贴整份风格指南、description 不要泛化、必须测试触发。