资讯动态

只装一个文件的极简设计:anti-defensive-writing 安装脚本安全校验与更新机制解析

发布时间:2026/10/16 10:46:30 来源:尧图企业网站定制
【免费下载链接】anti-defensive-writingCodex skill for removing defensive writing and strengthening prose.项目地址https://gitcode.com/gh_mirrors/an/anti-defensive-writing点击查看免费下载anti-defensive-writing 是一个用于 Codex 和 Claude Code 的写作技能Agent skill专门删除论文和专业文本中的防御性表达。它的安装设计非常克制整套 install.sh 安装脚本只下载一个SKILL.md文件配合先下载、后校验、再替换的安全机制即使下载失败也不会破坏已有安装。本文拆解这套安装脚本的安全校验与更新机制适合想了解 Codex skill 如何安全分发的新手阅读。为什么只装一个文件值得关注 大多数工具安装器会下载整个仓库压缩包但 anti-defensive-writing 反其道而行。查看包元数据 skill.json可以看到明确声明installed_files: [ SKILL.md ]安装完成后你的技能目录里只有这样一个结构技能目录/ └── anti-defensive-writing/ └── SKILL.md带来的好处很直接依赖极少不需要 Git、Python、Node.js 或包管理器macOS/Linux 有sh和curl即可占用极小不携带 README、图片、测试或 Agent 配置更新简单技能规则全部集中在 SKILL.md 一个文件里更新就是替换这一个文件。安装脚本如何工作三步流程install.sh 支持--dest目标目录、--ref分支/标签/提交和--force强制覆盖三个参数执行流程分三步前置检查确认目标位置不是符号链接、不存在已安装目录除非加了--force然后在目标目录下用mktemp创建临时暂存区staging下载并校验只抓取$REF/SKILL.md这一个文件到暂存区然后检查内容是否合法原子替换校验通过后才删除旧目录把暂存区整体mv为最终目录。如果脚本是本地直接运行而非管道执行且未指定--ref它会优先使用脚本旁边的本地SKILL.md完全跳过网络下载。安全校验机制四道防线 这套脚本的安全设计值得单独拆解第一道参数与路径检查if [ -L $target ]; then echo Destination is a symbolic link: $target. Choose another directory. 2 exit 1 fi拒绝写入符号链接避免安装过程意外改动链接指向的其他位置对--dest、--ref缺值或未知参数也会直接报错退出。第二道严格错误模式脚本开头是set -eu任何一条命令失败都会立即终止不会带病继续执行。第三道内容校验——拒绝假文件下载完成后脚本读取第一行并校验 YAML frontmatterIFS read -r first_line $staging/SKILL.md [ $first_line --- ] || { echo Invalid SKILL.md: missing YAML frontmatter. 2; exit 1; }如果下载回来的是 HTML 错误页或空文件会在替换旧版本之前就被拦截。第四道失败自动清理通过trap注册退出钩子无论成功、失败还是被中断临时暂存区都会被清除不会在技能目录里留下.tmp残留文件。更新机制失败不破坏旧版本 更新是这套机制最精巧的部分。核心原则是新文件下载并检查成功后才替换。默认不覆盖目标目录已存在时不带--force直接运行会报错退出已有安装原样保留先校验、后删除脚本注释写得很清楚——Download and validate before replacing an existing installation。只有暂存区的文件通过了 frontmatter 校验才会执行rm旧目录 mv暂存区的动作下载失败零影响curl -fsSL遇到 404 或网络错误会失败退出由于替换动作还没发生旧版本完好无损无需手动回滚。更新已有安装只需一条命令./install.sh --dest $HOME/.agents/skills --forceWindows 侧的 install.ps1要求 PowerShell 7实现了完全对等的逻辑-Dest、-Ref、-Force参数、符号链接检测、暂存目录加try/finally清理、以及同样的先校验后替换顺序。测试如何验证这些行为 仓库自带两套安装器测试用模拟下载的方式逐条验证上述安全承诺tests/test_install.pyShell 脚本测试覆盖四类安装目录、路径含空格、管道执行只下载SKILL.md、旧文件需--force才能清除、--ref生效、以及下载失败后旧安装保持不变tests/test-install.ps1PowerShell 脚本测试额外校验安装文件的哈希与源文件一致、失败后暂存文件被清理。其中最有代表性的断言是向不存在的 refmissing-ref发起--force更新后测试仍能从旧安装中读到完整且未变的技能内容——这正是失败不破坏旧版本承诺的自动化证明。手动更新与常见场景 指定版本安装加--ref 标签或提交Shell或-Ref 标签或提交PowerShell适合想锁定某个稳定版本的场景手动安装无需运行脚本在技能目录下建anti-defensive-writing文件夹把 SKILL.md 放进去即可需要按目录安装的工具可改用镜像副本 skill/anti-defensive-writing/SKILL.md旧文件残留如果技能目录里混进了别的文件用--force更新会被重置为只有一个 SKILL.md的干净状态需要 clone 仓库时仓库地址为 https://gitcode.com/gh_mirrors/an/anti-defensive-writing小结anti-defensive-writing 用只装一个文件把技能分发做到了极致精简而 install.sh 中的参数检查、严格错误模式、frontmatter 校验和原子替换四道防线加上 tests/ 下的自动化测试让这套极简设计在安全性上并不缩水装错有拦截、更新失败有兜底、过程无残留。对新手来说这也是一个学习如何写安全安装脚本的很好范本。赞分享【免费下载链接】anti-defensive-writingCodex skill for removing defensive writing and strengthening prose.项目地址https://gitcode.com/gh_mirrors/an/anti-defensive-writing点击查看免费下载相关推荐gh_mirrors/n1/n安装脚本安全审计防篡改与校验机制gh_mirrors/n1/n安装脚本安全审计防篡改与校验机制 引言安装脚本的安全痛点与防护价值 在开源项目的使用流程中安装脚本Install Scri开发工具CLITeleport 安装 Shim 脚本解析CDN 下载与安全校验机制的完整实现Teleport 安装 Shim 脚本解析CDN 下载与安全校验机制的完整实现 导读 Teleport 的用户文档中官方推荐的安装方式往往是一个简单的 cu网络安全认证鉴权运维后端Caveman 安装与更新完全指南Skill 安装器、本地运行时 CLI 与签名二进制校验机制Caveman 安装与更新完全指南Skill 安装器、本地运行时 CLI 与签名二进制校验机制 本文以 Caveman 仓库的官方安装文档 docs/tech人工智能AI 应用AI Agent提示工程开发工具MCP 服务创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑