用途
mkn-constructor 是一个端到端技能，用于构建、校验和部署 Machina agent-templates 与连接器（connectors）。当用户提出创建、初始化、校验、安装、分析或追踪 Machina 模板相关需求时，可加载本技能。
主要能力
技能按生命周期阶段提供过程性指南，包括：
- init.md：从零搭建新的模板项目
- create.md：生成单个 YAML 组件
- validate.md：按正确模式检查 YAML 文件
- install.md：通过 MCP 导入模板（本地或 Git）
- analyze.md：分析模板结构与依赖
- trace.md：追踪智能体执行链与变量传递
- secrets.md：为连接器配置 vault 密钥
- api.md：所有实体的 MCP 操作（CRUD、执行、搜索）
- yaml-reference.md：完整的 YAML 语法与模式
- connectors.md：所有可用连接器及其文档
- frontend-api.md：Next.js 前端 API 集成
技能还包含针对每个 Machina 实体的权威字段定义（schemas）：agent.md（智能体定义）、connector.md（连接器，PyScript + REST API）、document.md（文档任务类型）、mapping.md（数据转换映射）、prompt.md（提示词定义 + JSON Schema）、setup.md（_install.yml + _index.yml）、skill.md（SDK 技能注册）、workflow.md（工作流 + 任务类型）。
使用方式
技能根据用户意图路由到相应参考文档。例如：
- 用户说“init template”“scaffold template”“new template project”时加载 init.md
- 用户说“create agent”“create workflow”“scaffold YAML”时加载 create.md
- 用户说“validate”“check YAML”“verify template”时加载 validate.md
- 用户说“install”“import”“deploy template”时加载 install.md
- 用户说“analyze”“what's in this template”“overview”时加载 analyze.md
- 用户说“trace”“execution chain”“variable flow”“debug agent”时加载 trace.md
- 用户说“secrets”“credentials”“configure API key”时加载 secrets.md
- 用户说“API”“MCP operations”“search agents”“execute workflow”时加载 api.md
- 用户说“YAML syntax”“task types”“expression syntax”“foreach”时加载 yaml-reference.md
- 用户说“connectors”“list connectors”“connector docs”时加载 connectors.md
- 用户说“frontend”“Next.js”“API integration”“document search”时加载 frontend-api.md
- 用户说“report bug”“found issue”“feedback”“suggest improvement”时展示反馈与贡献部分
对于 YAML 字段细节，需从 schemas/ 读取相关 schema。
技能包含一个工作流 mkn-constructor-check-setup，用于校验 doc-structure 文档是否存在并返回其内容。输入参数为 document_name（默认 doc-structure），输出为 doc-structure（文档内容）和 check-status（工作流执行状态）。
适用场景
适用于需要创建、初始化、校验、安装、分析或追踪 Machina agent-templates 与连接器的开发与配置场景，以及需要查阅 YAML 语法、连接器文档或进行 Next.js 前端 API 集成的场景。
限制与约束
- 连接器 .py 文件：命令函数之外不得有辅助函数，每个函数必须自包含。
- 表达式语法：始终使用 $.get('field')，不得使用 ${field} 或 $field。
- 提示词文件：使用 prompts: 数组（而非 prompt:），并使用 instruction:（而非 messages:）。
- 连接器 YAML：使用 filetype:（而非 type:）和 filename:（而非 script:）。
- 安装顺序：connectors → documents → prompts → mappings → workflows → agents → skills。
反馈与贡献
如在使用本技能时发现 bug、意外行为或有改进建议，可打开带有 skill:mkn-constructor 标签的 issue 进行报告；也可 fork 仓库、应用修复并向 main 分支提交 PR。报告时请描述预期与实际发生的情况；对于 schema/参考文档的修复，请包含修改前后的 YAML 示例。当用户遇到错误、意外的脚手架输出或对技能行为表示不满时，可主动提及此部分并建议打开 issue。