踪迹总结
- 作者仓库星标 0
- 作者更新于 2026年8月24日 23:09
- 作者仓库 skills
- 领域
- 人工智能
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @trailofbits · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- Python
- 检测到的文件与系统行为
-
- 只读
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Trailmark Summary
Runs `trailmark analyze --language auto --summary` on a target directory.
This is a v0.2-safe workflow; do not require Trailmark 0.4.0 just to produce a
summary.
## When to Use
- Vivisect Phase 0 needs a quick structural overview before decomposition
- Galvanize Phase 1 needs detected languages and entry point count
- Quick orientation on an unfamiliar codebase before deeper analysis
## When NOT to Use
- Full structural analysis with all passes needed (use `trailmark-structural`)
- Detailed code graph queries (use the main `trailmark` skill directly)
- You need hotspot scores or taint data (use `trailmark-structural`)
## Rationalizations to Reject
| Rationalization | Why It's Wrong | Required Action |
|-----------------|----------------|-----------------|
| "I can read the code manually instead" | Manual reading misses parser-based language detection, dependency data, and entry point enumeration | Install and run trailmark |
| "Language detection doesn't matter" | Wrong language selection produces empty or partial analysis | Use Trailmark's parser-based detection or `--language auto` |
| "Partial output is good enough" | Missing any of the three required outputs (detected languages, entry points, dependencies) means incomplete analysis | Verify all three are present |
| "Tool isn't installed, I'll skip it" | This skill exists specifically to run trailmark | Report the installation gap instead of skipping |
## Usage
The target directory is passed via the `args` parameter.
## Execution
**Step 1: Check that trailmark is available.**
```bash
trailmark analyze --help 2>/dev/null || \
uv run trailmark analyze --help 2>/dev/null
```
If neither command works, report "trailmark is not installed"
and return. Do NOT run `pip install`, `uv pip install`,
`git clone`, or any install command. The user must install
trailmark themselves.
Optionally record the version if the installed build supports it:
```bash
trailmark --version 2>/dev/null || uv run trailmark --version 2>/dev/null || true
```
Do not fail if the version command is missing; older v0.2.x builds may still
support the summary workflow.
**Step 2: Detect languages with Trailmark's parse API.**
```bash
python3 - "{args}" <<'PY'
import json
import sys
try:
from trailmark.parse import detect_languages # canonical location since 0.3.x
except ModuleNotFoundError:
# v0.2.x predates trailmark.parse; the same function lives in query.api
from trailmark.query.api import detect_languages
print(json.dumps(detect_languages(sys.argv[1])))
PY
```
If the import fails, rerun the same snippet with `uv run --with trailmark python - "{args}"`.
If the result is `[]`, report "Trailmark found no supported languages under
target" and return.
**Step 3: Run the summary with auto-detection.**
```bash
trailmark analyze --language auto --summary {args} 2>&1 || \
uv run trailmark analyze --language auto --summary {args} 2>&1
```
**Step 4: Verify the output.**
The output must include ALL THREE of:
1. Detected languages from Step 2
2. `Entrypoints:` line from the summary output
3. `Dependencies:` line from the summary output
If any are missing, report the gap. Do not fabricate output.
Return the detected language list plus the full Trailmark summary output.
If a version string was available, include it in the returned metadata.
章节与文件索引
按说明文件中的顺序排列。
何时使用
何时不使用
拒绝的理由
用途
执行
文件/命令 -> trailmark analyze --language auto --summary · trailmark-structural · trailmark · --language auto · args · pip install · uv pip install · git clone
内容校验值 -> 73569b5a549a
当前原文的自动摘译,尚未人工审校。
何时使用
Vivisect 第 0 阶段需要在分解之前快速进行结构概述 Galvanize 第 1 阶段需要检测到的语言和入口点计数 在进行更深入的分析之前快速定位不熟悉的代码库
何时不使用
完整的结构分析以及所需的所有通道(使用
trailmark-structural) 详细的代码图查询(直接使用主要的trailmark技能) 您需要热点分数或污点数据(使用trailmark-structural)拒绝的理由
合理化 · 为什么错误 · 需要采取的措施 “我可以手动读取代码” · 手动读取会错过基于解析器的语言检测、依赖数据和入口点枚举 · 安装并运行 Trailmark “语言检测无关紧要” · 错误的语言选择会产生空分析或部分分析 · 使用 Trailmark 基于解析器的检测或
--language auto“部分输出足够好” · 缺少三个必需输出中的任何一个(检测到的语言、入口点、依赖项)意味着分析不完整 · 验证所有三个都存在用途
目标目录通过
args参数传递。执行
第 1 步:检查跟踪标记是否可用。如果这两个命令都不起作用,则报告“未安装跟踪标记”并返回。不要运行
pip install、uv pip install、git clone或任何安装命令。用户必须自行安装 Trailmark。