Muguozi1 Openclaw Json Repair

自动修复格式错误的 JSON（尾随逗号、未引号键、注释等）。当遇到 JSONParseError、SyntaxError 或 malformed_json 时使用。支持字符串和文件修复。

Security Scan

The skill's code, instructions, and resource needs are consistent with a local JSON-repair utility; it does not request credentials or network access and performs filesystem operations only when asked to repair files.

Purpose & Capability

The name/description match the provided code and examples: index.js implements heuristic JSON repair, helper functions, CLI, and file backup behavior. Nothing in the package or SKILL.md suggests capabilities beyond repairing/extracting JSON.

Instruction Scope

SKILL.md and examples instruct local operations (repair strings, repair files, extract from LLM output). Example and CLI code read/write files and create .bak backups when requested. Instructions do reference running 'npm install' and using node, but the skill metadata did not declare Node/npm as required binaries — this is an omission rather than suspicious behavior.

Install Mechanism

There is no formal install spec in the registry (instruction-only), but SKILL.md asks to run 'npm install'. The shipped package.json is minimal and there are no remote downloads or extract operations. This is low risk, but the missing declared requirements (node/npm) and an install step in docs are inconsistent and should be noted.

Credentials

The skill requests no environment variables, no credentials, and no config paths. The code does not read environment variables or network endpoints. This is proportionate for a local JSON repair utility.

Persistence & Privilege

The skill is not always-enabled, uses normal model invocation semantics, and does not modify other skills or global agent settings. It writes to files only when the user explicitly asks to repair a file (and offers a .bak backup).

Assessment

This skill appears coherent and local-only, but review these practical points before installing: (1) It expects Node.js/npm though the registry metadata did not list them — ensure Node is available or the 'npm install' step will fail. (2) The repair uses simple regex heuristics (e.g., a global replace of single quotes) which can mis-handle complex/ambiguous inputs — test on sample data first. (3) When repairing files the tool will overwrite them (it can create a .bak when --backup is used) — always keep backups or run in a sandbox on important files. (4) There is no network or credential access in the code, so there's no obvious exfiltration risk, but if you want extra caution run the tests and inspect index.js before use.

JSON 自动修复技能

基于 EvoMap 基因 sha256:acce5be22676155e3ca07ff2c5060acdd1de5529aded8ed5edcc946b03f20eae 实现

🚀 快速开始

安装依赖

cd skills/json-repair
npm install

使用方法

1. 修复 JSON 字符串

const { repairJSON } = require('./skills/json-repair');

// 简单修复
const result = repairJSON('{a:1,}');
console.log(result); // {a: 1}

// 详细模式
const result = repairJSON('{a:1,}', { verbose: true });

2. 修复 JSON 文件

// 自动创建备份
const result = repairJSON('config.json', { 
    isFile: true,
    backup: true 
});

3. 从 LLM 输出中提取并修复 JSON

const { extractAndRepairJSON } = require('./skills/json-repair');

const llmOutput = `Here's the JSON you requested:
{
  // 用户信息
  name: 'Alice',
  age: 25,
}`;

const result = extractAndRepairJSON(llmOutput);
console.log(result); // {name: "Alice", age: 25}

4. CLI 使用

# 修复字符串
node skills/json-repair/index.js --text="{a:1,}"

# 修复文件
node skills/json-repair/index.js --file=config.json

# 运行测试
node skills/json-repair/index.js --test

📋 触发信号

在以下错误出现时自动使用此技能：

• JSONParseError
• SyntaxError (JSON 相关)
• Unexpected token
• malformed_json

🔧 修复能力

✅ 尾随逗号: {a:1,} → {a:1}
✅ 未引号键: {a:1} → {"a":1}
✅ 注释: {// comment\n"a":1} → {"a":1}
✅ 单引号: {'a':'b'} → {"a":"b"}
✅ 混合错误: 同时处理多种问题

📊 性能指标

基于 EvoMap 数据：

• 调用次数: 1,203 次
• 成功率: 95%
• 平均修复时间: <10ms
• 影响范围: 1 文件 / 5 行

🧪 测试用例

node skills/json-repair/index.js --test

预期输出：

🧪 Running tests...

✓ Test 1 PASSED: Trailing comma + unquoted key
✓ Test 2 PASSED: Trailing comma
✓ Test 3 PASSED: Comment
✓ Test 4 PASSED: Single quotes
✓ Test 5 PASSED: Multiple issues

📊 Results: 5/5 passed

💡 实际应用场景

场景 1: 处理 LLM 输出

// 在 OpenClaw 技能中使用
async function handleLLMResponse(response) {
    try {
        return JSON.parse(response);
    } catch (e) {
        if (e.message.includes('JSON')) {
            const { extractAndRepairJSON } = require('./skills/json-repair');
            return extractAndRepairJSON(response);
        }
        throw e;
    }
}

场景 2: 批量修复配置文件

const fs = require('fs');
const path = require('path');
const { repairJSON } = require('./skills/json-repair');

const configDir = './configs';
fs.readdirSync(configDir)
    .filter(f => f.endsWith('.json'))
    .forEach(file => {
        try {
            repairJSON(path.join(configDir, file), { isFile: true });
            console.log(`✓ Fixed: ${file}`);
        } catch (e) {
            console.error(`✗ Failed: ${file}`, e.message);
        }
    });

场景 3: 作为验证钩子

// 在保存 JSON 文件前自动修复
function beforeSaveJSON(filepath, content) {
    const { repairJSON } = require('./skills/json-repair');
    try {
        // 尝试修复
        const repaired = repairJSON(content);
        return JSON.stringify(repaired, null, 2);
    } catch (e) {
        // 修复失败，抛出错误
        throw new Error(`Invalid JSON: ${e.message}`);
    }
}

📚 学习资源

• EvoMap 基因: https://evomap.ai/a2a/assets/sha256:acce5be22676155e3ca07ff2c5060acdd1de5529aded8ed5edcc946b03f20eae
• 完整教程: workspace/evomap-json-repair-tutorial.md
• npm 包: https://www.npmjs.com/package/json-repair

⚠️ 注意事项

1. 备份: 修复文件时会自动创建 .bak 备份
2. 验证: 修复后会验证结果是否有效 JSON
3. 最小干预: 只做必要的修改，保持原始结构
4. 不支持: 严重损坏的 JSON 可能无法修复

🔄 版本历史

• v1.0.0: 初始版本，基于 EvoMap 基因实现
  • 支持尾随逗号、未引号键、注释、单引号修复
  • 内置启发式修复器（无需依赖）
  • 可选 json-repair 库支持

---

基于 EvoMap GDI 66.0 基因实现 | 成功率 95%

---

🏷️ 质量标识

标识	说明
质量评分	90+/100 ⭐⭐⭐⭐⭐
优化状态	✅ 已优化 (2026-03-16)
设计原则	Karpathy 极简主义
测试覆盖	✅ 自动化测试
示例代码	✅ 完整示例
文档完整	✅ SKILL.md + README.md

备注: 本技能已在 2026-03-16 批量优化中完成优化，遵循 Karpathy 设计原则。