用途:本技能指导通过 Kuroco Admin MCP 工具创建内容结构(TopicsGroup),即内容项(Topics)的数据模式,包含自定义扩展字段。工具通常名为 topics_group-create,实际名称与参数以 tools/list 返回的 inputSchema 为准。使用前应先调用 /kuroco-content-structure-design 确定设计(分组、主数据表达、分类/标签/关联、ext_slug 命名等);本技能只负责按既定设计构建并调用工具。
主要能力:定义顶层参数 name、description、fields,以及内容主体字段与访问规则,如 content_input_type(0=WYSIWYG 正文,1=Textarea,2=Custom,推荐 2,正文用 ext_type 6 的 WYSIWYG 字段表达)、open_flg、non_public_flg、secure_level、writer_groups、need_application_groups、my_topics_only_limit_groups、can_save_draft_groups。支持字段类型涵盖 text、textarea、select、checkbox、wysiwyg、link、date、file、table、location、relation、html、s3file、json、csvtable、filemanager、vimeo、api、gcsfile、counter、number、bool、csvtable_checkbox、block_editor 等。字段通用属性包括 ext_title、ext_type、type、ext_slug、ext_help_msg、repetitions、required、searchable、template;可分组(可重复字段组)。
使用方式:确认 MCP 连接(whoami、tools/list),连接 URL 需含 topics_group 作用域;写入前与用户确认;调用后必须用 topics_group-get 读回验证,并可用 topics-describe 检查字段对外 API 形态。群组 ID 需用 group-list 解析,不可猜测。
限制:成功响应不代表字段按预期落库,被忽略的属性会静默失败;未设置的访问规则字段会以字符串 "0" 存储,表示未配置限制;写入工具层级为 mcp:tools.write 即可创建分组定义,但创建 API 端点需 mcp:tools.all 或更高;若 topics 在 approval_required 中,写入会进入审批流程;工具名动态生成,需以实际 inputSchema 为准;分类表与字段快照可能过时,应与实时 schema 核对。