mcpField
S
session-export-nocode

session-export-nocode

github.com/samuka007Agent 工作流083 次安装6 周前更新
代码仓库

关于 session-export-nocode

这是一项由用户触发的 Agent Skill,需与 `agent-session-batch-export` 基础技能配合,用于导出非代码会话。它从四个主题中选择会话,并交由基础运行器按确定性流程筛选和打包。

主要功能

  1. 01导出四类主题的会话
  2. 02调用基础技能扫描与筛选
  3. 03默认排除含凭据的会话
  4. 04支持批次确认选项
  5. 05生成交付清单

适用场景

  1. 01导出角色扮演或写作会话
  2. 02收集策划或报告分析会话
  3. 03在交付前要求确认
  4. 04按需允许含凭据的会话

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/samuka007/skills --skill session-export-nocode

安装后在 Claude Code 中输入/session-export-nocode确认已加载。

附带文件direction.jsonscripts/session-export-nocode.sh

详细介绍

导出非代码方向

这是一项由用户明确发起的交付操作。发布的 frontmatter 仅使用 Agent Skills 规范接受的字段,因此不会输出 disable-model-invocation:当前的 skills-ref 验证器会拒绝这个非标准字段。精简的描述和启动器确保此方向由用户发起。请将它与基础技能一同安装;Agent Skills 没有依赖字段:

npx skills add Samuka007/skills \
  --skill session-export-nocode --skill agent-session-batch-export -g -y

运行

调用启动器前,先阅读随附的 direction.json。这是该方向唯一的元数据文件。其 themes 数组声明了以下主题,启动器会按名称在基础技能的 themes/ 中查找每个主题:

role-play(角色扮演)、writing(写作)、planning(策划)、 report-analysis(报告分析)。

每个条目都是一个 { "theme": NAME } 对象,可选包含针对该主题的 override;随附的四个条目均为纯名称。购买约束由方向根目录中的 override 定义:exclude_keywords 词表——这些编码信号术语的缺失定义了“非代码”——以及打包门槛,一个有意设定的数字(min_user_turns),确保条目达到参考包的多轮对话水准。其值位于 direction.json,而不在此处。其余所有阶段均来自基础技能的 scripts/policy.json,本技能中的任何文件都不会重述这些值。

选择输出目录,然后运行:

bash scripts/session-export-nocode.sh \
  --out "$OUT_DIR"

--out 为必填项。为兼容早期调用方,仍接受 --request "$FULL_USER_REQUEST",但任何门槛都不会使用它,也不会将它转发到任何地方:启动器的行为不再取决于请求的措辞。

用户提供了扫描选项时,请一并传入: --allow-credentials、--agent、--workspace、--since 和 --min-lines。 启动器会解析标准的同级安装路径 agent-session-batch-export,并调用其共享契约:

agent-session-batch-export/scripts/export-direction.sh \
  --direction-file FILE --out DIR ...

启动器只是一个适配器。基础运行程序负责扫描、Python 筛选流程、策略阈值及其覆盖项、凭据检查、选择、复制、清单和交付。不要在此处实现或替代上述任何阶段。

审核策略

默认情况下无需人工处理。 启动器始终使用 --yolo 调用基础运行程序:确定性筛选流程决定选择结果,不会出现批次级提示,清单会记录 batch_confirmed=false。现在已不再有短语门槛——过去它会根据短语 直接导出、无需确认、不用确认 和 无须确认 来决定是否使用 --yolo,其他所有请求都不带该标志;在这条路径上,请求说的是 直接导出 还是 帮我导出,现在都没有区别。

如果用户明确要求先询问——例如“先确认”“让我审一遍”“需要我确认”等——则传入 --confirm:此时启动器会省略 --yolo,基础运行程序会显示一次批次级 [y/N] 提示。回答 y 后交付,并将 batch_confirmed=true;遇到 EOF 或任何其他回答,则不导出任何内容。这只是批次级检查点:此路径仍没有逐行筛选步骤,也没有需要填写的决策界面。

历史说明,供解释旧版安装使用:已废弃的门槛只会匹配上面的四个确切短语,而且只要这些短语出现在较长请求的任何位置,就会匹配;请求简短、沉默不语或说“帮我导出”都会保留提示。不要编辑筛选流程的输出或任何 candidates.tsv、screen.tsv 或 decisions.tsv 文件。只有在运行出现灾难性问题时,才可检查筛选流程报告;它不是决策界面,不得重写。绝不要选择保留或删除的行,也不要创建第二套筛选引擎。

可操作的失败处理

原样显示基础运行器的预检输出。如果 Windows 上无法使用 Python,请显示其 winget install Python.Python.3.13 提示,并询问用户是否安装后重试。切勿用语义模型筛查替代确定性的漏斗筛查。

默认情况下,运行器会将包含凭据的会话排除在交付内容之外(绝不会写入这些会话),并报告每项排除的来源、凭据种类以及排除总数;请将此列表转告用户。其余会话照常交付,排除项会记录在清单中。--allow-credentials 会将这些会话纳入交付:这是需要人工明确决定的操作,因此请向用户提供此选项,绝不能擅自启用。如果基础技能本身缺失,请显示启动器的安装说明,并询问用户是否同时安装这两项技能。

评论

支持 Markdown