用途:当用户要求围绕明确目标、输入、产出和校验标准创建或改进一项 Andru.ia 技能时使用;不用于自动安装或发布包。
主要能力:把可重复的目标转化为可用的 Andru.ia 指令,包含具体输入、产出与边界。默认以西班牙语撰写,同时尊重用户要求的语言和目标仓库的约定。遵循“文件夹 -> SKILL.md -> 校验”的结构,生成的技能需具备明确的专家角色,避免泛泛而谈。
工作流程:第一阶段收集技能的三项核心信息——技术名称(如 @cyber-sec、@data-visualizer)、专家角色、关键产出。第二阶段生成定制 SKILL.md(含描述、能力、黄金规则和使用方式)以及 PR 摘要(目标、改动文件、校验情况),不手工编辑生成的登记文件。第三阶段定位仓库根目录,创建 skills/<skill-id>/,ID 使用小写加连字符;按 docs/contributors/skill-template.md 编写 SKILL.md,含 frontmatter 及用法、示例、边界等章节。读取当前基础仓库的说明与 package.json;在 AAS 中先运行 npm run chain、npm run validate:references、npm run security:docs 和 npm run test 再提 PR,其他目标则使用其现行检查,不臆造命令。检查失败需修正源头并重跑,不得削弱校验器、把未运行的示例标为已测或在有失败时继续合并。检查通过后提交源码 PR,生成的登记文件属于规范同步流程。
规则:保留已有 ID;新技能按仓库要求选择小写连字符的描述性 ID,不把 Andru.ia 的数字前缀强加给其他项目。提示工程上应包含可观察的输入输出示例与校验标准,必要时可要求简短说明决策,但不要求暴露私有推理,也不承诺最高精度。
示例:用户要求创建 csv-quality-check 技能,报告缺失值和重复项且不修改 CSV。设计为:输入为已授权路径、分隔符和关键列;产出为包含行数、各列缺失值数量和重复键的报告;例如 id,name / 1,Ana / 1, 会产生重复键和缺失名称,CSV 保持不变;分隔符不明确时记为未解决输入而非干净报告;技能需记录大小、隐私和编码限制,并在 PR 中附上当前基础要求的检查。
限制:仅在任务明确符合上述范围时使用;输出不能替代针对具体环境的校验、测试或专家评审;撰写文本并不证明示例可用,可执行示例和随附资源需实际验证;不得因撰写技能而隐式安装、发布或改动仓库策略。