Skip to content
cccskills
FreePublished on GitHub

provenance

Collect operation events across an AI agent workflow and link them into traceable execution records. Search by tracking ID, time range, or responsible agent, with semantic indexing and local event storage to support audits and investigation.

OriginalShow the original description

收集系统全链路操作日志,生成可追溯的执行证据链与向量索引,是多智能体系统可观测性与安全审计的底座。

See how to install

Good for

  • Auditing handoffs and processing steps across multiple agents
  • Tracing related operations with a tracking ID
  • Finding past events by time range or responsible agent
  • Preserving events locally during a vector database outage

Files included (2)

  • SKILL.md2.2 KB
  • scripts/run_provenance.py2.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Provenance 留痕 Skill(太史阁)

使用方式

  • 由各官署在关键操作节点调用(或通过事件总线异步推送),写入证据链。
  • 提供按 trace_id / 时间窗 / 官署维度的检索接口,支撑审计面板与回滚定位。

输入(Input)

  • event:操作事件,含 actor(官署名)、action、target、timestamp、trace_id
  • payload:(可选)与事件关联的结构化产物引用

输出(Output)

  • evidence_chain:按 trace_id 串联的可追溯证据链
  • vector_index:用于语义检索的向量索引条目
  • query_api:按条件检索历史证据的接口描述

依赖(Dependencies)

  • Qdrant(向量存储,经 MCP 接入)
  • SQLite(结构化事件落地,本地兜底)
  • 各官署的事件上报协议(统一 schema)

失败处理(Failure Handling)

  • 向量库写入失败 → 本地 SQLite 缓存事件,恢复后异步补写,不阻塞主流程。
  • 单条事件 schema 非法 → 记录并丢弃该条,不影响整链写入。
  • 检索超时 → 返回最近一次成功快照并标注 stale。

复用价值(Reuse Value)

  • 可观测性底座:任何多 Agent 系统都能直接挂载,获得开箱即用的审计与回放能力。
  • 契合评审:Agent Infra 赛道「工程落地与运行验证及安全审计(20%)」维度的天然得分点。

复赛代码包执行(runnable package)

  • 真实入口:scripts/run_provenance.py
  • 执行等价于 core.runtime.AgentSession.run_stage("provenance"),调用 memory.taishige.TaiShiGeAgent.writeback(把全链路事件与四色卡片回流证据链,纯 Python 可离线)。
  • 运行:python skills/provenance/scripts/run_provenance.py
  • 产物:examples/snse_survey/provenance/(trace.jsonl + trace_summary.json,含每一条军机处派发与官署执行事件)。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

agent-team

FreeSummary

Organize AI agents into execution, management, and review roles for complex projects. Choose preset or custom teams, share project context and decisions, and combine their discussions and work into meeting records, feasibility reports, or implementation outputs.

  • Reviewing a technical architecture from several perspectives
  • Discussing product pricing across market and cost considerations
  • Assessing a new product's feasibility
anbeime/skill8.3KUpdated Oct 18, 2026

Generate character images, backgrounds, synthetic speech, and music for product videos featuring 小省导购员, a digital shopping presenter. Coordinate these assets with InfiniteTalk to produce a 25-second vertical video made from five scenes.

  • Producing a 25-second vertical product presentation video
  • Generating reference images for the 小省导购员 character
  • Creating business setting backgrounds for a video
anbeime/skill8.3KUpdated Oct 18, 2026

Convert PDF, Word, and Excel documents into structured Markdown for search and knowledge bases. The skill tries three parsers in sequence when needed and returns metadata, a confidence score, and the parser used.

  • Prepare documents for retrieval-augmented generation
  • Structure documents for an internal knowledge base
  • Extract structured text from contracts
anbeime/skill8.3KUpdated Oct 18, 2026

Organize parsed documents into four color-coded cards covering facts, explanations, risks, and actions. Preserve source references and generation details so readers can review evidence, identify uncertainty, and consider next steps in research, financial, or legal analysis.

  • Separating facts from interpretations in financial reports
  • Organizing evidence and risks in legal documents
  • Turning research documents into evidence-linked analysis cards
anbeime/skill8.3KUpdated Oct 18, 2026

Record operations across multiple AI agents and connect events into a traceable history. Search records by tracking ID, time window, or responsible component to support audits and investigations, with local storage available when the vector database fails.

  • Trace task dispatch and execution across agents
  • Search audit records by time or responsible component
  • Keep recording events during vector database failures
anbeime/skill8.3KUpdated Oct 18, 2026

Screen documents and external URLs before they enter a processing workflow. Check blocked domains and document permissions, then produce a pass or reject decision, a risk report, and a tracking ID for later review.

  • Screening documents before adding them to a knowledge base
  • Checking external URLs against a domain blocklist
  • Reviewing document permissions before processing
anbeime/skill8.3KUpdated Oct 18, 2026

See all skills by anbeime

Report a problem with this skill