@yottameta/yotta-compliance 0.0.0 → 0.1.0

package/SKILL.md

@@ -0,0 +1,208 @@
+---
+name: yotta-compliance
+version: 0.1.0
+description: 元规 —— 本地确定性的合规条款审查技能：对 UTF-8 文本 / Markdown 按版本化 JSON 规则包做确定性匹配、断言求值与证据抽取，输出带原文位置、命中规则、框架覆盖级别与来源条款的 Markdown / JSON 报告；当前 baseline_review 覆盖 PIPL 11 条规则与数据出境 4 条规则，GDPR / HIPAA / SOC2 / PCI-DSS / ISO27001 / 等保仅做 mapping_only 主题映射。触发：用户要审查隐私政策 / 数据处理条款 / 个人信息合规文本、检查 PIPL 或数据出境条款缺口、核对框架覆盖范围、生成可复算的合规审查报告、把条款审查接入 CI 闸门时。边界：只做基于确定性规则的审查建议，不构成法律意见、不替代律师或合规顾问；核心路径不调用 LLM、不联网、不解析 PDF / docx；mapping_only 框架不输出独立合规结论；不判断合同效力或诉讼结果。
+license: MIT
+---
+
+# 元规（yotta-compliance）
+
+本地、确定性、可复算的合规条款审查技能。元规对文本或 Markdown 执行规则匹配、断言求值与证据抽取，
+输出带**原文位置、命中规则、框架覆盖级别与来源条款**的审查报告。
+
+可信契约：
+
+- 每条风险结论必须回到原文证据、规则 id 和来源条款；
+- 没有证据不输出风险结论；
+- 同一输入得到同一结果（仅生成时间不同）；
+- `mapping_only` 框架只做主题映射，不输出该框架的独立合规结论；
+- 核心路径不调用 LLM、不联网，规则包只作为只读 JSON 数据。
+
+## 何时使用
+
+- 审查隐私政策、数据处理条款、个人信息处理规则等文本；
+- 检查文本是否出现 PIPL 要求的告知、合法性依据、保存期限、单独同意、个人权利、影响评估等要素；
+- 检查数据出境场景是否出现安全评估 / 标准合同 / 保护认证、单独同意、境外接收方告知、境内存储说明；
+- 生成可复算的 Markdown / JSON 审查报告，作为人工复核的起点；
+- 把达到指定严重度的条款缺口接入 CI 闸门。
+
+**Do NOT trigger**：
+
+- 不生成法律意见、不判断合同效力、不预测诉讼结果；
+- 不替代律师、合规顾问或监管机构的判断；
+- 不把 `mapping_only` 描述为“已审查该框架”；
+- v0.1 不直接解析 PDF / docx，需先转成 UTF-8 文本或 Markdown；
+- 不联网检索法条，不调用模型做语义裁决；
+- 不自动修改合同或替用户签署、提交任何文件。
+
+## 快速使用
+
+Windows 使用 `python`，Linux / macOS 使用 `python3`。
+
+```bash
+# 审查一个文本 / Markdown 文件（默认装载 pipl + data-export）
+python3 scripts/yotta_compliance.py review --input contract.md
+
+# 只审查 PIPL 包
+python3 scripts/yotta_compliance.py review --input contract.md --frameworks pipl
+
+# 输出 JSON，并在达到 high 时返回退出码 1
+python3 scripts/yotta_compliance.py review --input contract.md --format json --gate high --out report.json
+
+# 从标准输入读取
+python3 scripts/yotta_compliance.py review --stdin --frameworks pipl,data-export
+
+# 规则包操作
+python3 scripts/yotta_compliance.py rules list --framework pipl
+python3 scripts/yotta_compliance.py rules show PIPL-NOTICE-001
+python3 scripts/yotta_compliance.py rules validate --pack rules/pipl.json
+```
+
+报告默认写 stdout。只在显式提供 `--out` 时写文件，输出路径不得与输入文件相同，也不得写入规则包目录。
+
+## 命令一览
+
+| 命令 | 说明 |
+|---|---|
+| `review --input <file>` | 审查 UTF-8 `.txt` / `.md` / `.markdown` 文件 |
+| `review --stdin` | 从标准输入读取文本 |
+| `review --frameworks <list>` | 选择规则包，逗号分隔；缺省装载全部规则包 |
+| `review --format md\|json` | 输出 Markdown（默认）或 JSON |
+| `review --out <file>` | 写报告文件；缺省写 stdout |
+| `review --gate <level>` | CI 闸门：`off` / `low` / `medium` / `high` / `critical` |
+| `review --min-severity <level>` | 只输出达到该严重度的 finding；汇总计数仍保留全量 |
+| `review --include-safe` | 在 JSON `summary.checked_rules` 与 Markdown 未覆盖范围中列出已检查未命中的规则 |
+| `rules list` | 列出规则包与规则 |
+| `rules show <rule_id>` | 查看单条规则的说明、建议、来源与测试用例 |
+| `rules validate --pack <file>` | 校验规则包；不合规立即失败 |
+
+## 退出码
+
+| 退出码 | 含义 |
+|---|---|
+| 0 | 审查完成，未超过 gate |
+| 1 | 审查完成，存在达到 gate 的 finding |
+| 2 | 输入缺失、编码错误、路径不可用或超出输入上限 |
+| 3 | 规则包缺失、schema 无效或重复 `rule_id` |
+| 4 | CLI 用法错误 |
+
+## 覆盖范围
+
+当前正式规则包：
+
+| 规则包 | 框架 | 覆盖级别 | 规则数 |
+|---|---|---|---|
+| `pipl` | PIPL | `baseline_review` | 11 |
+| `data-export` | 数据出境 | `baseline_review` | 4 |
+
+`GDPR` / `HIPAA` / `SOC2` / `PCI-DSS` / `ISO27001` / 等保 当前为 `mapping_only`：
+只把基础规则映射到对应主题，不输出这些框架的独立合规结论。
+
+完整规则清单、主题映射与明确未覆盖范围见 `references/coverage.md`。
+
+## 报告包含什么
+
+Markdown 报告固定包含七节：
+
+1. 输入摘要（来源、大小、行数、SHA-256、规则包版本）；
+2. 框架覆盖摘要（规则包、框架、覆盖级别、状态、规则数）；
+3. 风险汇总；
+4. 逐条发现（严重度、置信度、框架映射、原文证据、位置、规则说明、建议动作、规则来源）；
+5. 未覆盖范围；
+6. 人工复核清单；
+7. 免责声明。
+
+JSON 报告固定提供稳定机器契约：`schema_version` / `tool` / `tool_version` / `generated_at` /
+`input` / `rule_packs` / `framework_coverage` / `summary` / `findings` / `review_items` / `disclaimer`。
+字段语义与证据结构见 `references/report-format.md`。
+
+示例（对一份缺少多项护栏的隐私说明运行默认规则包）：
+
+```text
+- 本次输出 11 条发现（全部 11 条）
+- high：3 条
+- medium：4 条
+- low：4 条
+- 已检查规则：15 条 ｜ 命中规则：13 条
+```
+
+实际结果取决于输入内容与所选规则包，示例数字不作为固定输出。
+
+## 规则包与证据链
+
+规则包是版本化 JSON 数据，包含 pack 元信息、条款类型词表、规则列表和可选的主题映射。
+每条规则必须声明 `test_ids`，且正式规则在发布前必须配有正例、反例和边界例。
+
+每条 finding 固定包含：
+
+- `finding_id`、`rule_id`、`severity`、`confidence`；
+- `framework_mapping`（基础框架与 `框架:mapping_only` 标签）；
+- `evidence`（`matched_span` 带原文 quote 与起止行列；`document_scope` / `section_scope` 只给范围）；
+- `rationale`、`remediation`、`source`。
+
+规则编写、断言契约与验收要求见 `references/rule-authoring.md`。
+
+## 已知局限（必须人工复核）
+
+- **词形匹配，不是语义理解**：absence 规则只判断检索词是否出现；同义但词形不同的表述可能漏检。
+- **文档级范围**：absence 的 `scope` 均为 `document`，任何位置出现检索词即视为已出现，不判断该表述是否适用于当前处理活动。
+- **否定句不建模**：「不会对外提供」「未经同意不得处理」等否定表述仍会触发候选匹配，可能产生漏报。
+- **只解析阿拉伯数字**：`保存期限：N年` 可解析；中文数字（如“三年”）不解析、不换算。
+- **数据出境人数阈值未进入 v1**：需要单位感知的数值原语；相关阈值规则推迟到规则包 v2。
+- **absence 类结论一律降低置信度**：medium / low 置信 finding 会进入人工复核清单，必须人工核验后才能采信。
+- **不直接解析 PDF / docx**：请先用文档适配器转成 UTF-8 文本或 Markdown。
+
+## 数据与安全边界
+
+- 纯本地运行：不发送原文、证据或报告，不联网检索法条，不调用模型；
+- 规则包是只读数据，不从规则正文执行代码；
+- 输入上限 2 MiB；仅接受 UTF-8 文本；
+- 除非显式设置 `--out`，报告只写 stdout；
+- 输出路径不得与输入文件相同，也不得位于规则包目录内；
+- 不缓存原文，不把合同内容写入日志。
+
+## 使用范围与授权
+
+- 只审查用户有权处理的文本；用户对输入来源与使用范围负责；
+- 审查结果用于发现文本缺口并辅助人工复核，不构成法律意见；
+- 不用于规避监管、伪造合规结论或对外声称“已通过某框架认证”；
+- 引用规则来源时保留规则包中的条款号与链接，不凭记忆补写条款。
+
+## 法律与红线
+
+- 元规是**审查建议工具**，不是律师事务所、认证机构或监管机关；
+- 规则命中只代表文本中出现了可观察现象，不代表真实业务未履行义务；
+- 规则未命中不代表不存在风险；`mapping_only` 框架不得被解读为已完成合规审查；
+- 使用本工具须遵守所在地法律法规与平台条款，最终判断由具备资质的专业人士作出。
+
+## 家族协同
+
+- **元信 yotta-verify**：规则包与技能发布前的确定性安全扫描；
+- **元忆 yotta-memory**：仅在用户显式选择时保存报告摘要与规则包哈希，不自动保存合同原文；
+- **元呈 yotta-present**：把审查结论呈现为报告或证据卡；
+- **元安 yotta-security-audit**：审计规则包与文件读取面的安全风险；
+- **元审 yotta-vetter**：自定义规则包安装前的来源与权限审查。
+
+## 开发与校验
+
+```bash
+# 全量契约测试（技能目录内）
+python3 scripts/test_yotta_compliance.py
+
+# 规则包校验
+python3 scripts/yotta_compliance.py rules validate --pack rules/pipl.json
+python3 scripts/yotta_compliance.py rules validate --pack rules/data-export.json
+
+# 语法检查
+python3 -m py_compile scripts/yotta_compliance.py
+```
+
+## 参考文档
+
+- `references/rule-authoring.md` — 规则包 schema、匹配原语、断言契约与规则验收；
+- `references/report-format.md` — Markdown / JSON 报告契约、字段语义与退出码；
+- `references/coverage.md` — 当前框架覆盖、规则清单、主题映射与明确未覆盖范围。
+
+## 免责声明
+
+本工具提供基于确定性规则的条款审查建议与证据链，不构成法律意见。

package/bin/install.js

@@ -0,0 +1,163 @@
+#!/usr/bin/env node
+/**
+ * yotta-compliance 跨平台安装器（YottaSkills）
+ * 用法:
+ *   npx -y @yottameta/yotta-compliance --agent <name>  # 按智能体默认用户级目录安装（推荐）
+ *   npx -y @yottameta/yotta-compliance --dir PATH      # 装到指定目录（用户改了目录的智能体）
+ *   npx -y @yottameta/yotta-compliance -g              # 安装到全部已知智能体用户级目录
+ *   npx -y @yottameta/yotta-compliance                 # 安装到检测到的项目级目录
+ *   npx -y @yottameta/yotta-compliance --list          # 列出智能体 -> 默认目录
+ */
+'use strict';
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const SKILL_NAME = 'yotta-compliance';
+const PKG_ROOT = path.join(__dirname, '..');
+
+// 智能体 -> 用户级默认技能目录（dirs 按优先级排列；--agent 装到第一个）
+// 依据官方文档：.agents/skills 并非通用目录，被 OpenCode / Cursor / Cline / Amp /
+// Kimi / Gemini CLI / GitHub Copilot 等读取；Claude Code 与 Codex 默认不读 .agents。
+const AGENT_DIRS = {
+  claude:    { label: 'Claude Code',      dirs: ['.claude/skills'] },
+  cursor:    { label: 'Cursor',           dirs: ['.cursor/skills', '.agents/skills'] },
+  codex:     { label: 'Codex',            dirs: ['.codex/skills'] }, // 特判：$CODEX_HOME/skills
+  gemini:    { label: 'Gemini CLI',       dirs: ['.gemini/skills', '.agents/skills'] },
+  goose:     { label: 'Goose',            dirs: ['.config/goose/skills', '.agents/skills'] },
+  amp:       { label: 'Amp',              dirs: ['.config/agents/skills', '.agents/skills'] },
+  opencode:  { label: 'OpenCode',         dirs: ['.config/opencode/skills'] }, // 特判：$XDG_CONFIG_HOME
+  windsurf:  { label: 'Windsurf',         dirs: ['.codeium/windsurf/skills'] },
+  workbuddy: { label: 'WorkBuddy',        dirs: ['.workbuddy/skills'] },
+  kiro:      { label: 'Kiro',             dirs: ['.kiro/skills'] },
+  trae:      { label: 'Trae Code CLI',    dirs: ['.traecli/skills'] },
+  'trae-cn': { label: 'Trae IDE（国内）',  dirs: ['.trae-cn/skills'] },
+  qwen:      { label: 'Qwen Code',        dirs: ['.qwen/skills'] },
+  comate:    { label: 'Comate 文心快码',   dirs: ['.comate/skills'] },
+  codebuddy: { label: 'CodeBuddy Code',   dirs: ['.codebuddy/skills'] },
+  kimi:      { label: 'Kimi Code CLI',    dirs: ['.kimi/skills'] },
+  agents:    { label: '通用 AGENTS.md',    dirs: ['.agents/skills'] },
+};
+
+// Codex 用户级目录特判：优先 $CODEX_HOME/skills，否则 ~/.codex/skills
+function codexUserDir() {
+  const base = process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
+  return path.join(base, 'skills');
+}
+
+// OpenCode 用户级目录特判：优先 $XDG_CONFIG_HOME/opencode/skills，否则 ~/.config/opencode/skills
+function opencodeUserDir() {
+  const base = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');
+  return path.join(base, 'opencode', 'skills');
+}
+
+function resolveUserDir(rel) {
+  if (rel === '.codex/skills') return codexUserDir();
+  if (rel === '.config/opencode/skills') return opencodeUserDir();
+  return path.join(os.homedir(), rel);
+}
+
+function installTo(dest) {
+  const target = path.join(dest, SKILL_NAME);
+  fs.mkdirSync(target, { recursive: true });
+  copyDir(PKG_ROOT, target, new Set(['package.json', 'bin', 'node_modules', '.git']));
+  console.log('installed -> ' + target);
+}
+
+function copyDir(src, dst, skip) {
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    if (skip.has(entry.name)) continue;
+    const s = path.join(src, entry.name);
+    const d = path.join(dst, entry.name);
+    if (entry.isDirectory()) {
+      fs.mkdirSync(d, { recursive: true });
+      copyDir(s, d, skip);
+    } else if (entry.isFile()) {
+      fs.copyFileSync(s, d);
+    }
+  }
+}
+
+function displayDir(rel) {
+  if (process.platform === 'win32') return '%USERPROFILE%\\' + rel.replace(/\//g, '\\');
+  return '~/' + rel;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const isGlobal = args.includes('-g') || args.includes('--global');
+  const list = args.includes('--list') || args.includes('-l');
+  let explicitDir = null;
+  const di = args.indexOf('--dir');
+  if (di !== -1 && args[di + 1]) explicitDir = args[di + 1];
+  let agent = null;
+  const ai = args.indexOf('--agent');
+  if (ai !== -1 && args[ai + 1]) agent = String(args[ai + 1]).toLowerCase();
+
+  if (list) {
+    console.log('智能体 -> 默认技能目录（--agent <name> 装到第一个，用户级）:');
+    for (const [key, v] of Object.entries(AGENT_DIRS)) {
+      const resolved = v.dirs.map(displayDir);
+      console.log('  ' + key.padEnd(10) + v.label.padEnd(18) + resolved.join('、'));
+    }
+    console.log('\n说明：Windows 用 %USERPROFILE%，Linux/macOS 用 ~；仅收录有官方默认目录的智能体。');
+    console.log('改了目录的请用 --dir <路径>，不要依赖默认位置；若设置了 CODEX_HOME / XDG_CONFIG_HOME，安装自动以该变量为准。');
+    return;
+  }
+
+  if (explicitDir) { installTo(explicitDir); return; }
+
+  if (agent) {
+    const info = AGENT_DIRS[agent];
+    if (!info) {
+      console.log('未收录智能体: ' + agent + '。请用 --dir <路径> 指定技能目录。');
+      console.log('可用: ' + Object.keys(AGENT_DIRS).join(', '));
+      return;
+    }
+    installTo(resolveUserDir(info.dirs[0]));
+    console.log('完成。');
+    return;
+  }
+
+  if (isGlobal) {
+    const seen = new Set();
+    for (const v of Object.values(AGENT_DIRS)) {
+      for (const d of v.dirs) {
+        if (seen.has(d)) continue;
+        seen.add(d);
+        installTo(resolveUserDir(d));
+      }
+    }
+    console.log('完成。');
+    return;
+  }
+
+  const PROJECT_DIRS = [
+    '.claude/skills',
+    '.cursor/skills',
+    '.codex/skills',
+    '.config/goose/skills',
+    '.config/agents/skills',
+    '.opencode/skills',
+    '.codeium/windsurf/skills',
+    '.workbuddy/skills',
+    '.kiro/skills',
+    '.traecli/skills',
+    '.gemini/skills',
+    '.trae-cn/skills',
+    '.qwen/skills',
+    '.comate/skills',
+    '.codebuddy/skills',
+    '.kimi/skills',
+    '.agents/skills',
+  ];
+  let installedAny = false;
+  for (const d of PROJECT_DIRS) {
+    if (fs.existsSync(d)) { installTo(d); installedAny = true; }
+  }
+  if (!installedAny) {
+    console.log('未检测到项目级智能体目录。可手动复制，或用 --agent <name> / -g 装到用户级。');
+  }
+}
+
+main();

package/install.sh

@@ -0,0 +1,132 @@
+#!/usr/bin/env bash
+# yotta-compliance 多智能体安装脚本（YottaSkills 模板）
+# 用法:
+#   bash install.sh --agent <name>  # 按智能体默认用户级目录安装
+#   bash install.sh --dir <path>    # 装到指定目录（用户改过目录的智能体）
+#   bash install.sh -g              # 装到全部已知智能体用户级目录
+#   bash install.sh                  # 检测并安装到已存在的项目级目录
+#   bash install.sh --list          # 列出智能体 -> 默认目录
+set -euo pipefail
+
+SKILL_NAME="yotta-compliance"
+SOURCE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+case "$(uname -s)" in
+  MINGW*|MSYS*)
+    SOURCE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -W)"
+    ;;
+esac
+
+# 智能体 -> 用户级默认目录（--agent 装到第一个）
+# .agents/skills 并非通用目录：OpenCode / Cursor / Cline / Amp / Kimi / Gemini CLI / GitHub Copilot 读取。
+# 判断当前环境：Windows Git Bash 用 %USERPROFILE%，Unix 用 ~
+_IS_WINDOWS=0
+case "$(uname -s)" in
+  MINGW*|MSYS*|CYGWIN*) _IS_WINDOWS=1 ;;
+esac
+dirs_for() {
+  case "$1" in
+    claude)     echo ".claude/skills" ;;
+    cursor)     echo ".cursor/skills .agents/skills" ;;
+    codex)      echo "__CODEX__" ;;
+    gemini)     echo ".gemini/skills .agents/skills" ;;
+    goose)      echo ".config/goose/skills .agents/skills" ;;
+    amp)        echo ".config/agents/skills .agents/skills" ;;
+    opencode)   echo "__OPENCODE__" ;;
+    windsurf)   echo ".codeium/windsurf/skills" ;;
+    workbuddy)  echo ".workbuddy/skills" ;;
+    kiro)       echo ".kiro/skills" ;;
+    trae)       echo ".traecli/skills" ;;
+    trae-cn)    echo ".trae-cn/skills" ;;
+    qwen)       echo ".qwen/skills" ;;
+    comate)     echo ".comate/skills" ;;
+    codebuddy)  echo ".codebuddy/skills" ;;
+    kimi)       echo ".kimi/skills" ;;
+    agents)     echo ".agents/skills" ;;
+    *)          return 1 ;;
+  esac
+}
+
+codex_dir() {
+  if [ -n "${CODEX_HOME:-}" ]; then printf '%s' "$CODEX_HOME/skills"; else printf '%s' "$HOME/.codex/skills"; fi
+}
+opencode_dir() {
+  if [ -n "${XDG_CONFIG_HOME:-}" ]; then printf '%s' "$XDG_CONFIG_HOME/opencode/skills"; else printf '%s' "$HOME/.config/opencode/skills"; fi
+}
+resolve_user() {
+  case "$1" in
+    __CODEX__)    codex_dir ;;
+    __OPENCODE__) opencode_dir ;;
+    *)            printf '%s' "$HOME/$1" ;;
+  esac
+}
+
+install_to() {
+  mkdir -p "$1/$SKILL_NAME"
+  cp -r "$SOURCE_DIR/." "$1/$SKILL_NAME/"
+  rm -rf "$1/$SKILL_NAME/.git"
+  echo "installed -> $1/$SKILL_NAME"
+}
+
+list() {
+  echo "智能体 -> 默认技能目录（--agent <name> 装到第一个，用户级）:"
+  for a in claude cursor codex gemini goose amp opencode windsurf workbuddy kiro trae trae-cn qwen comate codebuddy kimi agents; do
+    local dirs first
+    dirs="$(dirs_for "$a")"
+    first="${dirs%% *}"
+    case "$first" in
+      __CODEX__)    first=".codex/skills" ;;
+      __OPENCODE__) first=".config/opencode/skills" ;;
+    esac
+    if [ "$_IS_WINDOWS" = "1" ]; then
+      first="%USERPROFILE%\\${first//\//\\}"
+    else
+      first="~/$first"
+    fi
+    printf '  %-10s %s\n' "$a" "$first"
+  done
+  echo '说明：Windows 用 %USERPROFILE%，Linux/macOS 用 ~；仅收录有官方默认目录的智能体。'
+  echo '改了目录的请用 --dir <路径>，不要依赖默认位置；若设置了 CODEX_HOME / XDG_CONFIG_HOME，安装自动以该变量为准。'
+}
+
+main() {
+  local agent="" dir="" global=0 show_list=0
+  while [ $# -gt 0 ]; do
+    case "$1" in
+      --agent) shift; agent="${1:-}" ;;
+      --dir)   shift; dir="${1:-}" ;;
+      -g|--global) global=1 ;;
+      --list|-l) show_list=1 ;;
+      *) echo "未知参数: $1" >&2; exit 2 ;;
+    esac
+    shift
+  done
+
+  if [ "$show_list" = "1" ]; then list; return; fi
+  if [ -n "$dir" ]; then install_to "$dir"; echo "完成。"; return; fi
+  if [ -n "$agent" ]; then
+    local dirs first
+    if ! dirs="$(dirs_for "$agent")"; then
+      echo "未收录智能体: $agent。请用 --dir <路径> 指定技能目录。" >&2; exit 2
+    fi
+    first="${dirs%% *}"
+    install_to "$(resolve_user "$first")"; echo "完成。"; return
+  fi
+  if [ "$global" = "1" ]; then
+    echo "安装到全部已知智能体用户级目录..."
+    local dirs rel
+    for a in claude cursor codex gemini goose amp opencode windsurf workbuddy kiro trae trae-cn qwen comate codebuddy kimi agents; do
+      dirs="$(dirs_for "$a")"
+      for rel in $dirs; do install_to "$(resolve_user "$rel")"; done
+    done
+    echo "完成。"; return
+  fi
+  local installed=0 d
+  for d in .claude/skills .cursor/skills .codex/skills .config/goose/skills .config/agents/skills .opencode/skills .codeium/windsurf/skills .workbuddy/skills .kiro/skills .traecli/skills .gemini/skills .trae-cn/skills .qwen/skills .comate/skills .codebuddy/skills .kimi/skills .agents/skills; do
+    if [ -d "$d" ]; then install_to "$d"; installed=1; fi
+  done
+  if [ "$installed" = "0" ]; then
+    echo "未检测到项目级智能体目录。可用 --agent <name> / -g 装到用户级，或 --dir 指定。"
+  fi
+}
+
+main "$@"

package/package.json

@@ -1,23 +1,46 @@
 {
   "name": "@yottameta/yotta-compliance",
-  "version": "0.0.0",
-  "description": "Placeholder package for the YottaMeta yotta-compliance skill.",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "keywords": [],
-  "author": "",
+  "version": "0.1.0",
+  "description": "YuanGui (yotta-compliance) — a local, deterministic compliance-clause review skill for AI agents: reviews UTF-8 text / Markdown against versioned JSON rule packs with deterministic matching and assertion evaluation, and produces Markdown / JSON reports in which every conclusion carries the source-text span, matched rule id, framework coverage level and official clause citation. Baseline coverage: 11 PIPL rules and 4 cross-border data-transfer rules; the GDPR / HIPAA / SOC2 / PCI-DSS / ISO27001 / China MLPS frameworks are mapping_only. Triggers: reviewing privacy policies, data-processing clauses or personal-information compliance text; checking PIPL or data-export gaps; checking framework coverage; generating reproducible compliance review reports; gating clause review in CI. Boundaries: deterministic rule-based review suggestions only — not legal advice, not a substitute for a lawyer or compliance consultant; the core path uses no LLM and no network access and does not parse PDF / docx; mapping_only frameworks produce no independent compliance conclusion; it does not judge contract validity or litigation outcomes. Fully local, zero-dependency (Python 3.8+ standard library).",
   "license": "MIT",
-  "type": "commonjs",
+  "keywords": [
+    "agent-skills",
+    "yotta-compliance",
+    "yottaskills",
+    "compliance",
+    "pipl"
+  ],
+  "files": [
+    "SKILL.md",
+    "LICENSE",
+    "NOTICE",
+    "README.md",
+    "README.zh-CN.md",
+    "CHANGELOG.md",
+    "install.sh",
+    "references",
+    "rules",
+    "scripts",
+    "assets",
+    "bin",
+    "!scripts/test_*.py",
+    "!scripts/fixtures",
+    "!scripts/fixtures/**",
+    "!**/__pycache__",
+    "!**/*.pyc",
+    "!**/*.pyo"
+  ],
   "repository": {
+    "type": "git",
     "url": "git+https://github.com/YottaMeta/yotta-compliance.git"
   },
   "publishConfig": {
     "access": "public"
   },
-  "bugs": {
-    "url": "https://github.com/YottaMeta/yotta-compliance/issues"
+  "bin": {
+    "yotta-compliance": "bin/install.js"
   },
-  "homepage": "https://github.com/YottaMeta/yotta-compliance#readme"
+  "scripts": {
+    "test": "python scripts/test_yotta_compliance.py"
+  }
 }