tomevault-io Kunlun-M 通用 Skill（脚本落地版）
本 skill 只包含可直接执行的脚本与最小流程，优先用脚本完成动作，不在 SKILL.md 里展开原理解释。
0. 一键准备环境（没有 Kunlun-M 时）
python skills/kunlun-m-general/scripts/bootstrap_kunlunm.py --repo-dir ./Kunlun-M
默认行为：优先 git clone，失败回退 zip；然后执行 pip install、复制 settings.py、初始化 DB、load rules/tamper。
1. 用脚本执行日常动作（推荐）
约定：--repo-root 指向 Kunlun-M 目录（里面有 kunlun.py）。
扫描
python skills/kunlun-m-general/scripts/kunlun_ops.py --repo-root ./Kunlun-M scan -t <target> -lan php -b vendor,node_modules -d
生成 rule（漏报补齐）
python skills/kunlun-m-general/scripts/kunlun_ops.py --repo-root ./Kunlun-M gen-rule -lan php --name "<rule_name>" --match "<regex>"
python skills/kunlun-m-general/scripts/kunlun_ops.py --repo-root ./Kunlun-M scan -t <target> -lan php -r <id>
生成 tamper（误报治理/框架适配）
python skills/kunlun-m-general/scripts/kunlun_ops.py --repo-root ./Kunlun-M gen-tamper --name <proj> --controlled "$_GET,$_POST"
python skills/kunlun-m-general/scripts/kunlun_ops.py --repo-root ./Kunlun-M scan -t <target> -lan php -tp <proj>
同步到数据库（可选：仅 Web 管理需要）
python skills/kunlun-m-general/scripts/kunlun_ops.py --repo-root ./Kunlun-M sync --rule --tamper
2. 最小概念（只留决策点）
- 规则（rule）≈ sink（危险点）：要扫哪些危险函数/语句就生成/调整 rule，然后用
scan -r <id>回归 - 污点策略（tamper）≈ source + repair：要定义输入源或净化函数就生成/调整 tamper，然后用
scan -tp <name>回归
更详细的概念与场景说明见：concepts.md
3. 测试命令（冒烟验证）
在本仓库根目录执行（或把 --repo-root 指向你的 Kunlun-M 目录）：
python skills/kunlun-m-general/scripts/bootstrap_kunlunm.py --repo-dir ./Kunlun-M --force
python skills/kunlun-m-general/scripts/kunlun_ops.py --repo-root ./Kunlun-M gen-rule -lan php --name "Skill Smoke Rule" --match "echo|print" --force
python skills/kunlun-m-general/scripts/kunlun_ops.py --repo-root ./Kunlun-M gen-tamper --name skill_smoke --controlled "$_GET,$_POST" --force
python skills/kunlun-m-general/scripts/kunlun_ops.py --repo-root ./Kunlun-M scan -t ./Kunlun-M/tests -lan php -d
4. 报告（给 skill 输出稳定结果）
已有 CI 报告产出脚本：tools/ci_scan.py，输出稳定的 JSON（meta/summary/vulnerabilities/exit），适合 skill/CI 使用。
python tools/ci_scan.py --target ./Kunlun-M/tests --output artifacts/kunlun-ci.json --fail-on none
python skills/kunlun-m-general/scripts/render_ci_report.py --input artifacts/kunlun-ci.json --output artifacts/kunlun-ci.md
报告模板参考： report_template.md
多平台结构（同一份内容）
- 该 skill 不维护多份表述；不同平台主要差异是“放在哪个目录/可选元数据文件”
- 平台落地路径与说明： README.md
- 一键复制到目标平台目录（可选）：
python skills/kunlun-m-general/scripts/install_platform.py --platform <openclaw|codex|claude-code|hermes> --scope <user|project> --repo-root <repo>
安全约束
- 不在 rule/tamper 中写入真实密钥、token、真实 URL、账号密码等敏感信息
- 只维护“函数名 / 输入源 / 规则编号 / 规则逻辑”这类抽象信息
Source: LoRexxar/Kunlun-M — distributed by TomeVault.