SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场artifact-yylo

artifact-yylo

办公与效率

查看项目

更新于 10-25 02:03

技能介绍

用途

artifact-yylo 用于捕获和检索持久化的 YYLO Ledger 工件记录（Artifact Records）。它把 Ledger 作为工件身份与元数据的唯一可信来源，适用于需要保留可验证证据的场景，例如 stdout 输出、模型响应、生成的报告以及绑定操作与输入/结果的回执。

该技能明确区分：Ledger 工件记录是持久证据，不是 npm/Python 发布工件，也不代表隐式的发布或部署请求。

主要能力

  • 捕获前分类：按证据类型选择 profile，包括 stdout（有界进程输出）、model-output（智能体/模型响应）、report（生成的人类或机器可读结果）、receipt（绑定操作及其输入/结果的证据）。
  • 选择 payload 模式：inline（嵌入记录的小型不可变字节）、local（Ledger 存储中不可变的内容寻址字节）、external（带 URI、摘要与大小的不可变外部字节）、link（无不可变字节保证的 URI 引用）。当后续验证依赖精确字节时，应优先使用不可变证据；link 不得作为内容寻址证明呈现。
  • 显式创建：使用文件/标准输入传输并提供媒体类型，例如： yy ledger artifact create --title "Focused test report" --profile report --mode local --media-type application/json --file report.json
  • 外部不可变内容：需提供受支持的 URI、SHA-256 摘要与大小（以已安装帮助为准）。不得嵌入 URI 凭据。Ledger 会拒绝不安全协议、路径穿越、大小/摘要不匹配、超大捕获以及已知机密模式。
  • 来源信息：仅附加受支持且非机密的来源信息，如 actor、agent、model、session、run、invocation、task 或 workflow 身份。task/workflow 来源使用不可变记录 ID。
  • 保留策略：可选择临时、标准或永久保留；保留元数据本身不授权删除。
  • 检索与验证： yy ledger artifact search --profile report --projection summary --limit 20 -f json yy ledger artifact get RECORD_ID -f json yy ledger artifact history RECORD_ID -f ndjson 建议先使用有界的元数据/摘要投影，再请求 payload 细节；依赖证据前验证 profile、模式、媒体类型、摘要、大小、来源、保留、修订与不可变 ID。

使用方式

在 YYLO 控制器中使用 yy ledger，或独立使用 yylo-ledger。先检查 COMMAND artifact --help；若不可用，不要手动创建存储文件。

操作文档边界：此存储约定仅在用户/项目已采用 YYLO Ledger 时适用。仓库说明与请求的交付物位置优先；通用工件请求不授权将现有计划/文档移入 Ledger。机密检测是纵深防御而非保证：捕获前应检查并脱敏 payload，包括外部引用的字节。

应将新的 PDR、架构与迁移契约、计划、报告、回执与执行证据存储为工件记录。通过全新的外部文件起草，以有意的 profile 与不可变 payload 模式捕获，读回并验证其 ID、摘要、大小、来源、保留与历史，然后再删除草稿。对于人类可读的 PDR/契约，除非已安装帮助提供了更具体的已批准 profile，否则使用 report profile。

product docs/ 仅用于随产品发布的文档。切勿将操作证据放入其中以制造任务产品差异。保留遗留的 .juno_task/specs 文件，但不要新建它们作为回退。若已安装的工件 API 不可用，应停止并保留外部草稿，请求 Ledger 升级；不要将其放入任务正文、响应、产品文档或手动管理的控制器路径。

适用场景

  • 需要捕获或检索持久化的 YYLO Ledger 工件记录（stdout、model-output、report、receipt），并附带来源、保留与不可变 payload。
  • 新的操作 PDR、契约、计划、报告与回执应存放于此，而非产品文档、任务正文或新的 .juno_task/specs 文件。

限制

  • payload 不可变：替换需通过前驱/后继关系表达，绝不能覆盖字节。归档是生命周期转换，不是删除。
  • 仅限机密安全：不得嵌入 URI 凭据；Ledger 会拒绝不安全协议、路径穿越、大小/摘要不匹配以及已知机密模式。
  • 保留元数据从不授权删除；发布、公开、上传与生产变更始终需要单独授权。

示例

yy ledger artifact search --profile report --projection summary --limit 20 -f json yy ledger artifact get RECORD_ID -f json

（改编自 yylo-dev/yylo-skills (MIT) - v2.0.1；为上游合规添加了 frontmatter、When to Use/Limitations 与安全边界。）