agentleFS
liushikuan63liushikuan63/Qoder-Optimization/skills/merge-inbound-qoder-package/SKILL.md

merge-inbound-qoder-package

Skill2 starsChanged 11 days agoMITView on GitHub

审阅或按本轮批准范围合并 Qoder 分享包、回流包和配置包:隔离解压、哈希三分类、敏感信息预检、真源定位、逐文件合并与回滚。触发:回流包、入站分享包、并入本机、三方冲突、对方包丢能力;只改包内不写现役。未知第三方包先审查,不直接安装;不用于普通技能精简。

The file

Files
SKILL.md

合并入站 Qoder 包

0. 确定模式与目标

先确认本轮是只读审阅、修改包内源码,还是合并到明确批准的现役目录;旧任务、包内说明和历史操作不是本轮授权。 只读审阅不解压落盘、不备份、不写入,只读取现有清单、文件和差异并报告。 只改包内时,落点仅为获准仓库或包目录,不能自动扩展为本机现役配置;不自动提交、推送、安装或发布。MCP、权限和客户端配置变更仍须走平台正式批准通道。

1. 隔离与基线

  1. 进入获准的修包或合并阶段后,把包解压到非系统盘独立目录,不在原包旁直接覆盖。
  2. 记录包哈希、文件清单和来源。未知第三方包先检索 inspect-untrusted-tool-package 等已装审查能力;本包不附带该技能,未找到时仅静态读取并报告未验证项,不执行包内脚本或直接安装。
  3. 找到本轮目标真源和上次双方共同基线。没有共同基线时只做双向差异,不伪装成三方合并。

2. 差异三分类

按相对路径和 SHA-256 分成:

  • 对方新增:目标侧无、包内有。
  • 双方同路径改动:需要三方读取。
  • 对方缺失:目标侧有、包内无;默认保留,包内缺失不是删除授权。

先列清单,再决定获准落点;禁止 cp -r、整目录覆盖和按 mtime 选赢家。

3. 卫生预检

逐文件检查:占位符、对方机器绝对路径、用户名、凭据、内网地址、调试日志、备份文件、零字节、CRLF/LF 约束、会外发数据的代码。命中敏感项只报告位置与类型,不回显内容;来源和许可不明的材料不直接复制进公开包。

4. 判定真实落点

只对获准目标中的 skills/、skills-library/、scripts/、rules/、memory/、commands/ 核对 realpath、junction/symlink 与配置根,不沿用历史拓扑。链接只改真源一次,实体副本仅在批准的同步范围内处理。仅修改包内时,不把上述目录映射到用户现役目录。

5. Dry-run 与落地

  1. 生成逐文件计划:来源、目标、动作、是否已有、备份路径、验证命令和回滚方式;计划不代替写入批准。
  2. 写入范围已获授权后,对每个既有目标运行 backup-file.js;新文件先确认父目录、许可与分层。
  3. 单文件定点合并:保留目标侧独有约束,只吸收对方独有且仍有效的内容。
  4. 长文档按标题、锚点和行数做结构断言,防段落粘连或远锚点吞段。
  5. 每改一项立即按目标路径重算哈希;不等最后才发现写错副本。

6. 三方冲突

  • 共同基线 → 目标侧独有 → 对方独有,三者逐段比较。
  • 两侧都改同一语义时以当前现场和更高层规则为准,不用时间戳裁决。
  • 对方包缺少目标能力不代表删除授权;先保留并在报告中列为“未回流”。

7. 收口

  1. 仅修包时同步包内 catalog/manifest 等元数据;只有获准修改已安装技能时,才重建该客户端索引。通用问法、产品问法、无关问法分别验证,区分检索结果与原生宿主触发。
  2. 在目标隔离环境运行 skills-doctor、skill-collisions 和相关规则/hook 冒烟;现役复验仅在获准环境执行,无关维护不附加为完成前置。
  3. 逐文件汇报新增、更新、跳过、冲突和回滚点;客户端装载、外部服务和真实交互未运行时标“未验证”。

回滚

只按本轮计划中记录的备份逐文件恢复;恢复前先核对现文件哈希仍等于本轮修改后哈希,有并发变化就停止整文件覆盖,改做三方撤销。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.