kev365/xways-xtension-builder-skill

# X-Ways X-Tension Builder 技能 [](https://github.com/kev365/xways-xtension-builder-skill/actions/workflows/ci.yml) 一个用于编写 [X-Ways Forensics](https://www.x-ways.net/forensics/) **X-Tensions** 的 [Claude Code](https://claude.com/claude-code) **skill** 和 **knowledge base** —— 这些 `xways-.dll` 插件扩展了 X-Ways（封装外部 取证工具，原生解析 artifacts，驱动 Events Viewer / Directory Browser）。 它为 Claude 提供了特定于 X-Ways 的*操作指南*：选择模板，执行 scaffold + 重命名 + 设置身份标识，接入项目约定（helper-exe 验证、 Ctrl-to-save、输出目录、subprocess stdio、manager 兼容性），以及 根据提炼的、可引用的参考笔记验证每个 `XWF_*` API 调用，以确保 生成的代码绝不会凭空捏造 API。 ## 包含内容 | 路径 | 内容说明 | | --- | --- | | [`.claude/skills/xways-xtension-authoring/`](.claude/skills/xways-xtension-authoring/) | 该 skill —— 包含 `SKILL.md` 流程路由器、参考指南和 PowerShell 脚手架/构建/规范脚本 | | `.claude/commands/xtension.md` | `/xtension` 斜杠命令 | | [`templates/x-tensions/`](templates/x-tensions/) | 起始模板：`cpp`、`cpp-xtmgr-compatible`、`python` 以及功能丰富的 CLI 包装器 `wrapper` 模板 | | [`docs/`](docs/INDEX.md) | 提炼的 X-Tension API 参考笔记 + [约定库](docs/conventions/index.md) | | [`CHANGELOG.md`](CHANGELOG.md) | 发布历史 + 排队等待下一个版本的已知问题 | ## 安装说明（作为 Claude Code 插件） ``` /plugin marketplace add kev365/xways-xtension-builder-skill /plugin install xways-xtension-authoring@xways-xtension-builder ``` 然后要求 Claude“scaffold 一个新的 X-Tension”、“将 `` 封装在一个 X-Tension 中”， 或运行 `/xtension new `。该 skill 也会在这些短语上自动触发。 **两种使用方式：** - **作为插件安装**（如上所述）—— 你可以在任何项目中获得该 skill 的*指导*以及 `/xtension` 命令。最适合用于“封装此工具” / “审查我的 X-Tension”等对话。 - **克隆并在 Claude Code 中打开** —— 该 skill 会从 `.claude/skills/` 自动加载，并且**脚手架/构建脚本针对克隆的 工作副本运行**（它们会在克隆中创建 `x-tensions//` 并在其中构建）。 这是实际使用内置脚本和模板*编写* X-Tension 的途径。 ## 快速开始 安装后，通过对话或直接驱动脚本，即可 scaffold 并构建你的第一个 X-Tension： - **对话方式：** 要求 Claude *“scaffold 一个封装了 `` 的新 X-Tension”*， 或运行 `/xtension new myscanner`。 - **脚本方式**（当你克隆了该代码库时），在 PowerShell 中从代码库根目录运行： # 从 CLI 包装器模板 scaffold（首先执行 dry-run 以预览计划） .claude/skills/xways-xtension-authoring/scripts/new-xtension.ps1 -Name myscanner -Template wrapper -DryRun .claude/skills/xways-xtension-authoring/scripts/new-xtension.ps1 -Name myscanner -Template wrapper # 填写你的工具命令 + 结果解析（查看 # x-tensions/xways-myscanner/ 中的 // TODO 标记），然后构建 + 部署到你的 X-Ways 安装目录中： .claude/skills/xways-xtension-authoring/scripts/build-xtension.ps1 -Name xways-myscanner -DeployRoot "<你的 X-Ways 安装目录>" 有关构建工具链和 SDK，请参阅[前置条件](#prerequisites)。 ## 前置条件 - **X-Ways Forensics 21.x+** (Windows x64) 用于运行你构建的 X-Tensions。 - **MSVC (x64)** —— “x64 Native Tools Command Prompt for VS 2022”（VS 2019 Build Tools 也可以；`build.bat` 会自动引导其中任何一个）—— 用于编译。 - **X-Ways X-Tension SDK**（即 `X-Tension.h` 头文件）用于构建 C++ X-Tensions。本代码库**不**附带 SDK —— 其版权归 X-Ways AG 所有。 请参阅 [docs/getting-the-sdk.md](docs/getting-the-sdk.md) 获取你自己的副本。 ## 用法 ``` # Scaffold（先进行 dry-run 以检查计划的副本 / 重命名 / 编辑） .claude/skills/xways-xtension-authoring/scripts/new-xtension.ps1 -Name -Template wrapper -DryRun # Build（先关闭 X-Ways —— 它在运行时 DLL 会被锁定；不支持 hot reload） .claude/skills/xways-xtension-authoring/scripts/build-xtension.ps1 -Name xways- ``` 请参阅[knowledge base](docs/INDEX.md)、 [约定库](docs/conventions/index.md) 以及 [API guardrail](.claude/skills/xways-xtension-authoring/references/api-guardrail.md)。 ## 许可证与归属 MIT —— 请参阅 [LICENSE](LICENSE)。API 参考笔记经过提炼、释义 或经验推导；X-Ways SDK、手册和用户论坛内容 **并未**在此处分发。关于 X-Ways AG、`xwf-api-rs` 以及社区 X-Tension 作者的致谢请见 [NOTICE](NOTICE)。 ## 关于本项目制作方式的说明 该 skill 和 knowledge base 是**在 AI agent （Claude）的帮助下生成的**，来源于为 X-Ways Forensics 构建 X-Tension 时收集的笔记、实验和约定。我们已经对材料进行了审查，但 错误和过时的细节在所难免 —— **非常欢迎提出更正、澄清 和提供更好的信息。** 请提交 issue 或 PR。

标签：AI合规, AI辅助编程, C++, Claude Code插件, SOC Prime, X-Ways Forensics, 代码生成, 安全意识培训, 开发工具, 数字取证, 数据擦除, 渗透测试工具, 自动化脚本, 逆向工具