Nox-Lumen AutoNox-Lumen Auto

skill-architect

能力

引导用户从零设计并构建高质量的 Agent 技能,覆盖独立 skill 和 MCP-enhanced 工作流。

适用触发:

  • "我想创建一个新 skill"
  • "帮我把这个流程封装成 skill"
  • "I want to automate this workflow"
  • "how do I teach my Agent to do X"
  • 需要创建 SKILL.md 文件时

不适用于:创建 subagent 或撰写技术设计文档。

5 阶段工作流

严格按顺序执行,不允许跳步

Rendering diagram…

① Discovery — 理解需求

  • 理解用户想解决什么问题
  • 定义 2–3 个具体用例
  • 明确触发条件成功标准
  • 识别边界情况、已有工具能力

② Architecture — 选模式 + 规划结构

选择合适的设计模式:

模式何时用
顺序工作流流程固定、步骤清晰
迭代精化需要多轮反馈、逐步收敛
上下文感知输出高度依赖当前上下文
领域智能需要大量专业知识、LLM 逻辑主导

规划目录结构、撰写 description(含触发短语 + 负向边界)。

③ Craft — 编写

  • frontmatter(name kebab-case + description ≤ 1024 字符)
  • 指令正文(≤ 500 行)
  • 真实示例
  • 错误处理路径

④ Validate — 校验

  • 结构校验(frontmatter 格式、kebab-case、无 README.md)
  • 触发测试(描述是否会被正确唤起)
  • 指令质量审查(歧义、冗余、缺失)

⑤ Deliver — 交付

使用 skills_create(name, description, content) 工具创建技能。content 只传 Markdown 正文(# 标题开始),不含 --- frontmatter 块

硬性规则

规则要求
namekebab-case,无空格无大写
description[功能] + [触发短语] + [不适用场景],≤ 1024 字符,不含 XML 尖括号
SKILL.md正文 ≤ 500 行
不许跳 Discovery禁止跳过 Discovery 直接生成 SKILL.md

反模式(必须避免)

  • description 写成"一段描述性文字"而没有触发短语
  • 未做 Discovery 就开始 Craft
  • 把用户原话直接抄进 skill 而不提炼通用规则
  • 不明确负向边界("不适用于...")

触发方式

/skill-architect 我想把"每周周报整理"这个流程做成 skill

自然语言示例:

  • "帮我做一个 skill 把我常用的 SQL 查询封装起来"
  • "给我的 Agent 教会怎么做 A/B 测试报告"
  • "turn this workflow into a skill"

相关文档

On this page