该技能用于从 Kuroco 站点实际配置生成现况规格文档,源资料为日文,面向开发交接与文档维护。
用途:通过 Admin MCP 的只读工具收集站点配置,按模板生成 Markdown 正文加 Mermaid 图表,覆盖内容定义(项目表、ER图)、API 一览、认证与会员组、审批工作流、自定义处理与批处理、表单等实际使用的模块;同时保存机器可读定义文件(API 的 OpenAPI 3.1.0 与内容定义原始响应)。因以实际配置为依据,避免与现物偏离。
主要能力:一、生成按“1 定义=1 页”分割的文档结构,含 README、contents、functions、api、auth、workflow、forms、schema 等目录。二、用 flowchart、erDiagram、sequenceDiagram、stateDiagram-v2 可视化结构。三、提供基于规格书的往返回路:用户编辑后可依申请流程比对现况与编辑、提示差异计划,但本技能不执行写入,写入需改用其它技能并取得批准。四、可选 PDF 与 zip 转换。
使用方式:建议使用带 /readonly 的作用域 URL(如 https://{site}.g.kuroco.app/direct/rcms_api/admin_mcp/x/all/readonly),执行 whoami 确定连接上下文,再按模块逐一收集配置。文档生成后做链接、Mermaid 语法、覆盖度、往返回路与保密信息检查。PDF 化可执行 node scripts/build-pdf.mjs spec/ -o dist/,需本地环境、Chrome 与网络。
限制:仅使用只读工具,不调用 create、update、delete 等写入工具;不收集会员或内容实际数据,仅以 cnt=1 查看总数;不转写自定义处理源码全文;不将令牌、密钥等真实值写入文档。部分资料中未说明的内容暂未提供。