Index of every page on this site: llms.txt
All skills
cat-xierluo avatar

/self-evolve

@5fb69a0
Run it yourself

扫描本机 Claude Code、Codex、WorkBuddy、CodeBuddy、ZCode 等 Agent 会话,保留初始化和增量处理记录,低成本初筛后由当前 Agent 提炼经验、迭代与 Skill 沉淀建议,生成可独立打开的 HTML 报告。也用于复盘当前对话、接续每周沉淀或检查扫描覆盖。无需单独配置模型 API Key;不自动应用建议或安装 Skill。

Use this Skill: https://skilld.dev/gh/cat-xierluo/legal-skills/self-evolve

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

references00-first-run-setup.md

≈1.2k tokens on demand. Your agent reads this file only when SKILL.md points to it.

初始化与第一次使用

本公开路线只需 Python 3.11+,不需要单独的模型 API Key,也不要求先配置 YAML 或定时任务。

1. 运行初始化扫描

让当前 Agent 在本 Skill 目录运行:

python3 scripts/first_run.py
# 同等入口
python3 scripts/public_workflow.py scan

默认先处理最多 200 个新建/变化输入。首次自动建立专用外置数据目录和 SQLite 账本;运行结果给出证据包 packet 与初筛 HTML report。再次运行复用账本,不重新解析未变会话;预算未处理的旧会话继续补齐。不能因看到报告就认为深度分析已完成。

2. 让当前 Agent 分析并生成最终 HTML

读取 packet,按 分析合同 判断经验、改进及 Skill 沉淀去向,写 analysis JSON 后运行:

python3 scripts/public_workflow.py import-analysis \
  --packet <本轮packet.json> --analysis <analysis.json>
python3 scripts/public_workflow.py status

打开返回的总览 HTML,通过侧栏进入个人画像、深度分析、Skill 沉淀、会话与证据、扫描与覆盖和运行说明。确认实际覆盖的 Runtime、来源完整性、失败和预算待处理、分析证据及 Skill 安装说明。移动报告时一并保留同前缀的七个 HTML 文件;它们可以直接离线打开,不需要启动服务。“建议创建”尚不是一个已完成、可安装的 Skill。

3. 数据保留在哪里

默认沿用本机平台数据根,包含 runtime/public-workflow/ledger.sqlite 和 runs/<run-id>/ 的证据包、报告与分析修订。只保存脱敏摘要和处理记录,不复制原始会话。保留这个目录即可保留初始化节点、去重记录、失败与全部历史扫描。

需要自定义时,首次运行前设置一个专用空/不存在的叶目录:

export SELF_EVOLVE_DATA_ROOT="<专用数据目录>"

也可复制 config/data_root.example.yaml 到 config/data_root.yaml 后配置 data_root(需可选 PyYAML 才读取 YAML)。不要将主目录、共享非空目录或 Skill 源码目录当作状态根。移动状态前保留整个旧根,按旧工作台迁移合同核对;不要只搬 HTML 然后清空账本。

data_root.yaml、core_skills.yaml、asset_owners.yaml 是本地覆盖文件,不入 Git,也不进入发行包;发行清单的 excluded 字段会登记这三个路径。若旧安装中已有同名文件,升级后保留本地版本继续使用。

4. 自定义来源与排障

默认扫描已登记 Runtime 的标准目录;自定义配置根或布局可显式补充:

python3 scripts/public_workflow.py scan \
  --source <runtime>:claude=<JSONL会话目录>

支持的格式为 claude / codex / trace / gemini。格式不匹配会明确失败,不把存在的目录当成功。ZCode 默认是只读任务搜索索引摘录;完整消息的新版本 adapter 后续再接。详细目录、覆盖局限和格式合同见公开版工作流。

退出码:0 表示本轮扫描或导入执行完成;1 表示扫描存在部分读取/解析失败(报告和成功记录仍保留);2 表示参数、账本或导入校验失败。失败记录在后续预算允许时重试,数据库损坏时保留原件,不自动重建。

5. 建议每周调用

确认首次 HTML 与覆盖后,在正在使用的 Runtime 中配置每周一次的定时 Agent 调用,复用 每周提示词。时间与时区由用户决定,界面没有定时能力时保留手动入口。只运行系统 cron 的扫描脚本不能代替 Agent 分析。配置任务、调用成功和真实周期触发分别核验。

旧首次引导不再自动运行 SiliconFlow/Claude CLI 分析;历史部署仍可按需查 历史工作台。

本地配置与旧调度

config/data_root.yaml、config/core_skills.yaml、config/asset_owners.yaml 和 config/scheduled_tasks.yaml 是本机配置,不纳入 Git 或发行包。公开主流程不要求这些配置;仅在需要相应功能时复制同名 .example.yaml 并按本机情况填写。旧调度属于兼容入口:未配置时不运行任务;模板任务默认关闭,须由用户逐项启用并自行配置外部 Cron。

发行构建以指定 Git 提交中的 release-files 允许清单为范围,支持仓库根下 self-evolve 与 skills/self-evolve 布局;维护文件和本机配置另受硬排除保护。独立发行目录不自带源仓历史,重建发行物需要提供对应 Git 仓库及提交 OID。

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning18d3 checks · Risk SAFE
  • Gen Agent Trust Hub18d

    The skill is a tool for analyzing local AI agent session history to suggest improvements. It naturally requires access to local logs and performs local script execution, but it includes robust privacy gating and instructions to mitigate risks from untrusted data.

  • Socket18d

    No alerts

  • Snyk18d

    Risk: MEDIUM · 1 issue

Signed by skilld at 5fb69a0. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 4 weeks ago
Other metadata
metadata
{
  "version": "1.28.1",
  "homepage": "https://github.com/cat-xierluo/legal-skills",
  "author": "杨卫薪律师(微信ywxlaw)"
}

README badge

README badge for cat-xierluo/legal-skills/self-evolve