// TUTORIAL · FROM ZERO TO FIRST CASE

Tutorial Guide

You only need to let AI read README_AI.md completely; environment identification, initialization, routing, tool checking, case and verification are all automatically completed by AI.

v1.0.1 Current version 41 routing rules 163 regression cases 42 tracked modules Windows + Ubuntu CI
// BEFORE YOU START

Before You Start

reverse-skill is a client-agnostic security task routing package that is not tied to OpenCode, Codex, Claude Code, Cursor, or other single platforms. During normal use, you do not need to execute the commands on this page one by one: give the warehouse to AI and let it read it completely README_AI.md That’s it.

There's only one thing you really need to do:In the warehouse workspace, give the following startup prompt to the AI. AI finished reading README_AI.md The platform must then be automatically detected, the tool index refreshed, the rule chain loaded and the task continued; only authorizations, credentials, commercial licenses or external status changes require your confirmation.
Please read README_AI.md completely and strictly follow Section 0 to automatically complete the initialization and checking of the current environment. Please automate normal steps; only ask me if you need my authorization, credentials, commercial license, or will change external state. After completion, report the identified platform, rule chain, and tool index status, and then continue processing the authorization tasks I will give next. I don't need to manually copy and execute the process commands shown on the tutorial page.
AI should actively complete the configuration and report the results, rather than re-throwing refresh, bootstrap, case-init or test commands to the user for manual execution.
This page has been updated with v1.0.1:The current baseline is 41 structured routes (R0–R40), 163 regression cases, 42 tracked modules, Windows + Ubuntu CI, and includes structural consistency and supply chain version fixed gating.

Only two steps are needed for actual useThe following four boxes show the automatic links within AI, not the user operation list.

what you get

  • 41 structured routing rules (R0–R40)
  • Client-independent specialized skills and optional adaptation layers
  • Native tool index and per-task bootstrapped toolchains
  • Scope, Timeline, Evidence, Finding, Review evidence chain

What does AI automatically check?

  • Current operating system, distribution and real installation path
  • Git, PowerShell/Bash, Node.js and Python
  • Does the current task require Java/JDK or specialized tools?
  • Can the missing capabilities be installed automatically or does it require user authorization?

First choose your usage pathAuthorization and network configuration are different for different tasks, do not mix them.

local sampleAPK, EXE, firmware and other own files. Use offline, external connections are prohibited.
Isolation Laboratory/CTFBuild your own shooting range or open competition. Use lab_only Or clear game goals.
Authorized online targetThere must be written authorization and an inventory of assets. Use authorized_target_only
Authorization boundaries:Must be completed before any target operation case-init, ensure auth.status=granted and network_profile Ready. When not ready, only read-only planning and preparation can be performed.
// INSTALLATION

AI automatic initialization and first check

Finish reading README_AI.md Then, AI will automatically complete this section: identifying the platform and installation path, checking the basic environment, generating a native tool index, loading the rule chain, and bootstrapping the tool on demand when the task really requires it. The following commands are used to show what it is doing and how to check if it fails, rather than requiring the user to run them one by one.

Automatic execution principle:Steps that can be safely completed by the AI in the current workspace should be performed and reported directly; only system permissions, commercial software licenses, account credentials, authorization boundaries, or external side effects require user intervention.
01

AI recognition platform and basic environment

AI selects Windows, Kali, normal Linux or macOS paths based on the actual system and performs corresponding checks on its own. When basic dependencies are missing, it should first determine whether it can be safely installed automatically instead of asking users to copy the entire command.

WindowsWindows PowerShell 5.1+ or PowerShell 7

git --version powershell -NoProfile -Command "$PSVersionTable.PSVersion" python --version node --version
Git has a version number; PowerShell ≥ 5.1; Python 3.x; Node.js ≥ 22.12. Java is only required in the APK/Java Tools task.

Ubuntu / Debian / macOSOrdinary Linux and macOS use the Bash script in the root directory of the warehouse

git --version bash --version python3 --version node --version
Python must be 3.x; macOS comes with Bash 3.2, which can also run universal bootstrap without forcing the installation of a new version of Bash.
02

AI confirms version and warehouse root directory

If the warehouse is already open, the AI directly retrieves the README_AI.md The real root directory is deduced from the location, and the user does not need to clone repeatedly. Only choose the stable version if you have not yet obtained the project. v1.0.1 or main

Stable version v1.0.1

git clone --branch v1.0.1 --depth 1 https://github.com/zhaoxuya520/reverse-skill.git cd reverse-skill git status --short

Main line latest version

git clone https://github.com/zhaoxuya520/reverse-skill.git cd reverse-skill git status --short
git status --short By default, there is no output, indicating that the newly cloned workspace is clean. If there are local modifications, confirm whether these modifications need to be retained before updating.
03

AI automatically generates native tool index

README_AI.md Explicitly require the index to be refreshed on the first run. AI should generate itself skills/tool-index.md with skills/tool-index.json, record the tools and paths that are actually available on the current machine, and cannot require users to copy the results of other machines.

Windows

powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/refresh-tool-index.ps1 Get-Item skills/tool-index.md, skills/tool-index.json

Ubuntu / Debian / macOS

bash skills/scripts/refresh-tool-index.sh ls -l skills/tool-index.md skills/tool-index.json

Kali Linux

bash kali/scripts/refresh-tool-index.sh ls -l skills/tool-index.md skills/tool-index.json
The terminal shows the index write location; two index files exist. After opening Markdown, the tool status should include "found/not found", the actual path, and a bootstrap prompt.
04

AI updates securely when needed

Only when the user requests an update, the AI checks the workspace first and retains existing changes; the mainline only accepts fast-forward updates. When local modifications or branch differences are discovered, AI should first report the differences and not allow users to blindly execute override commands.

git status --short git fetch --tags --prune git pull --ff-only
Do not directly overwrite local modifications when you see them.First confirm whether the difference belongs to you or the generated file; submit, stage or backup before updating. Destructive resets to resolve version conflicts are prohibited.
05

AI automatically reports initialization results

After completing the configuration, AI actively reports the platform, actual path, rule chain, tool index and missing capabilities. If the authorized task has not been received at this time, it will stop in the preparation stage and will not access any external targets.

AI INITIALIZATION REPORT Platform: <Automatically identified system and distribution> Skill root: <Real path to the warehouse where README_AI.md is located> Tool index: generated / refreshed Rules: README_AI.md → platform doc → RULES.md → routing Missing tools: auto-install when the PRIMARY Skill actually needs them Ops gate: case-init + auth.status=granted + network_profile
Automated reports from AI should clearly mention structured routing,case-initauth.status=grantednetwork_profile, and does not tie the core to a single client.
Platform documents are automatically selected by AI:Kali → kali/README-kali.md;Ubuntu / Debian → docs/platforms/linux.md;macOS → docs/platforms/macos.md. Users do not need to decide in advance which copy to read.
AI should not install all tools at once.it looks first tool-index.md, only necessary capabilities for which the current PRIMARY Skill installation status is "Not Found"; ask the user again when a license or additional authorization is required.
// CLIENT INTEGRATION

Access AI client

Access does not require users to install a special plug-in or manually configure the entire set of routes. Usually just open the repository with the code agent and let it read it in full README_AI.md;Then platform identification, rule loading and tool indexing are all automatically completed by AI.

clientOpen methodmust readThings to note
CodexOpen the repository as a workspaceAGENTS.md、README_AI.md、RULES.mdAutomatically route by project directive; do not copy rules to global prompts
Claude CodeStart from the repository root directoryREADME_AI.md、RULES.mdRequest read-only check before starting Case
Cursor / Cline / WindsurfOpen Folder Open the warehouseREADME_AI.md、RULES.mdMake sure the Agent can read the entire skills directory
OpenCodeUse the warehouse as projectREADME_AI.md、RULES.mdOptional use of project-level skills.paths; must not be a core dependency
Other clientsUsing Project Commands/Skill PortalREADME_AI.md、RULES.mdJust be able to read the file and run the native script

AI automatic access linkThis is to check whether the AI correctly executes README_AI.md, not the user’s four-step operation.

01

AI locates the root directory of the warehouse

Agent passes README_AI.md Deduce the Skill Root from its real location and confirm that it can be accessed RULES.md with skills/

02

AI loads the complete rule chain

The Agent automatically selects platform documents, refreshes the index, reads RULES and structured routing according to README_AI section 0, and should not stop after just summarizing the README.

The following tips are for troubleshooting purposes only:Only the client does not execute automatically README_AI.md It is only used to check the rule chain when the system starts; there is no need to send a second set of configuration prompts during normal first startup.
You are now at the root of the reverse-skill repository. Please read README_AI.md and RULES.md and list the complete file chain from "User Tasks" to "PRIMARY Skill". Then explain when case-init, tool-index, bootstrap and case-review are used respectively. Read-only check, no external network actions are performed.
At least:routing.json / MASTER-ROUTING.mdcase-init → PRIMARY SKILL.mdtool-index / bootstrap → Evidence → Case Review。
03

AI automates read-only routing checks

AI can call routing entries without accessing external targets, verify that the output contains PRIMARY, confidence, and route-scope.md. Commands are selected and executed by the AI.

# Windows powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/master-route.ps1 -Hint "Android APK reinforcement decompilation" # Linux / macOS / Kali bash skills/scripts/master-route.sh --hint "Android APK reinforcement decompilation"
PRIMARY should point to skills/apk-reverse/SKILL.md. If it falls into R0, first confirm the current branch,routing.json Works fine with Python 3 (required for Bash Router).
04

AI confirms platform neutrality

Not modified when switching clients routing.json. The client only changes the loading method of project instructions, and the routing results remain consistent with the Case structure.

Do not copy the entire set of rules to the client configuration.in warehouse skills/config/routing.json It is the only source of truth for routing, and the client only does loading and calling.
// YOUR FIRST CASE

Complete the first authorization case

After the initialization is completed, the user only needs to provide the task, authorization basis, allowed scope, prohibited actions and expected delivery. AI will automatically complete routing, Case initialization, Scope structuring and Guard; the commands in this section just unfold the automatic process for you to see. This tutorial uses a reserved example domain name https://lab.example/, will not connect to the real target.

The only thing the user needs to provide in this section is the authorization task description.The subsequent route, case-init, scope, case-guard and Skill loading should be automatically executed by AI. AI cannot forge authorization for users; when authorization information is insufficient, stop and ask.
01

You provide authorized tasks

The task description contains at a minimum the type of goal, basis for authorization, scope of permissions, prohibited actions, and deliverables. The more specific the description, the more reliable the routes and scopes automatically generated by AI.

Target: The company's own testing environment https://lab.example/. Authorization basis: Internal work order SEC-001; only this domain name is allowed, DoS, phishing and access to real user data are prohibited. Task: Review the request signature and front-end JS call chain of the login interface. Delivery: Reproduction steps, evidence, Finding, repair recommendations, and Case Review report.
02

AI automatically previews routes

AI first reads, analyzes text and writes out route-scope.md, the target will not be accessed. Windows and Bash use the same routing.json

# Windows powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/master-route.ps1 -Hint "Authorized front-end signature JS reverse encryption parameter analysis" # Linux / macOS / Kali bash skills/scripts/master-route.sh --hint "Authorized front-end signature JS reverse encryption parameter analysis"
PRIMARY -> skills/js-reverse/SKILL.md Label: JS / frontend reverse | confidence: medium Wrote .../work/master-route-.../route-scope.md ACTION: Open PRIMARY SKILL.md now and execute ACTION REQUIRED.
PRIMARY points to js-reverse, confidence is medium, the secondary usually contains a generic inverse; this is a normal result of multiple keyword hits and should be viewed both in the routing file and the full matrix.
03

AI automatic initialization Case

AI extracts authorization, assets and network modes from the tasks provided by the user, automatically selects the platform entrance and runs initialization; when there is insufficient information, it asks first and cannot make up the authorization fields by itself.

Windows PowerShell

powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/case-init.ps1 ` -Hint "Authorized front-end signature JS reverse encryption parameter analysis" ` -CaseName "demo-js-signature" ` -AuthGranted ` -AuthBasis "written_contract" ` -EvidenceOfAuth "internal ticket SEC-001" ` -TargetUrl "https://lab.example/" ` -NetworkProfile "authorized_target_only"

Linux / macOS / Kali

bash skills/scripts/case-init.sh \ --hint "Authorized front-end signature JS reverse encryption parameter analysis" \ --case-name "demo-js-signature" \ --auth-granted \ --auth-basis "written_contract" \ --evidence-of-auth "internal ticket SEC-001" \ --target-url "https://lab.example/" \ --network-profile "authorized_target_only"
CASE -> .../work/demo-js-signature PRIMARY skill: skills/js-reverse/SKILL.md (...) auth.status=granted network_profile=authorized_target_only ready_for_act=true NEXT: open PRIMARY SKILL.md and ACT within scope
generate work/demo-js-signature/, which contains at least scope.mdtimeline.mdworkitems.mdREADME.mdevidence/notes/ and report/
04

AI field-by-field verification Scope

The AI automatically checks the table below and confirms to the user the authorization boundaries that cannot be derived, in particular prohibited actions, activity types and data processing constraints. The user is responsible for confirming the true authorization, and the AI is responsible for writing and verifying the structure.

FieldExamplesJudgment criteria
auth.statusgrantedThere must be traceable authorization basis and cannot be inferred from the Agent.
auth.evidence_of_authinternal ticket SEC-001Write work orders, contracts, contest pages or proof of ownership
in_scope.assetshttps://lab.example/Itemize assets; don’t use vague “company-owned domain names”
in_scope.activitiesrecon, reverse, reportList only permitted actions
out_of_scope.activitiesDoS, phishing, data exfilExplicitly prohibited items
network_profile.modeauthorized_target_onlyThe network can only go to the in_scope list
signoff.ready_for_acttrueIt becomes true only when all the aforementioned fields are completed.
05

AI automatically runs Case Guard

The AI automatically performs a Guard before any command to access the target. Only continue with exit code 0; exit code 2 will stop at the preparation stage and explain what is missing. You cannot leave the Guard command to the user and then continue directly.

# Windows powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/case-guard.ps1 -CaseRoot "work/demo-js-signature" # Linux / macOS / Kali bash skills/scripts/case-guard.sh --case-root "work/demo-js-signature"
show CASE-GUARD OK. If prompted with auth, network, assets or ready_for_act issues, return to scope.md Correction; do not use --force / -Force Bypass normal workflow.
06

AI automatically enters PRIMARY Skill

After Guard passes, AI reads skills/js-reverse/SKILL.md of ACTION REQUIRED, tool requirements, stop conditions, and product format, then continue execution within the Scope.

How to make local offline samples?Private files such as APK, EXE, and BIN do not require public network targets

bash skills/scripts/case-init.sh \ --hint "Analyze the encryption protocol of your own APK" \ --case-name "demo-apk-offline" \ --preset offline-sample \ --sample "./samples/app.apk"
Windows offline sample:AI available -AuthGranted -AuthBasis own_system -InScopeAssets "C:\samples\app.apk" -NetworkProfile offline initialization. Entrances will be kept conservatively ready_for_act=false; After AI confirms file ownership, out_of_scope and "no external connections" to the user, it then updates the Scope and automatically runs Case Guard, without the user having to edit manually.
  • The routing result is consistent with the task intent
  • Authorization evidence, assets, allowed and prohibited actions are all written into Scope
  • Case Guard returns OK, Force bypass not used
  • Tool paths come from tool-index.md, not guessed
  • Evidence traceable to Finding and Final Report
  • Desensitization experience is written into field-journal to avoid repeated pitfalls.
// END-TO-END WORKFLOW

Complete workflow

The following shows the complete link of AI automatically executed in the background to facilitate auditing and troubleshooting. During normal use, users do not need to call these scripts step by step; the AI must retain the input, output, and intermediate products of each step and pause when user authorization is required.

01

AI: Task → Structured Routing

routing.json Score based on task semantics and select PRIMARY. The output is saved in work/master-route-*/route-scope.md, so you can look back and see why you chose that Skill at that time.

02

AI: Routing → Authorization Case

case-init Create Scope, Timeline and Work Item;case-guard It is the machine check before ACT.

03

AI: Case → Special Skill

AI reads the Skill's ACTION REQUIRED and necessary references, records the plan, tool requirements, stopping conditions, and expected evidence, and runs the scan directly without skipping gates.

04

AI: Check and bootstrap missing tools

AI open skills/tool-index.md, only processes Required tools of the current Skill. When the status is ready, use the absolute path in the index directly; when the status is missing and automatic installation is allowed, run bootstrap again.

Windows example: install jadx and refresh the index

powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/bootstrap-reverse.ps1 -Capability @('jadx') powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/refresh-tool-index.ps1

Linux/macOS example

# First check the supported capability names bash skills/scripts/bootstrap-reverse.sh --list # Only install the capabilities required for the current task bash skills/scripts/bootstrap-reverse.sh jadx bash skills/scripts/refresh-tool-index.sh

Kali example

bash kali/scripts/bootstrap-reverse.sh jadx apktool frida jshookmcp bash kali/scripts/refresh-tool-index.sh
After refreshing tool-index.md It should change from "Not Found" to "Discovered" and give the executable path. If still not found, don't guess the path; look at bootstrap's failure output and manualInstallHint.
Commercial or hand installation tools:IDA Pro, JEB, BurpSuite, etc. may require a license or in-app extension. Bootstrap should only give guidance, not bypass authorization, download unknown binaries, or fake a successful installation.
05

AI: Continuously update timeline while executing

AI writes for every important action timeline.md: time, role, command or reference, result summary, artifact, evidence ID, and next step; failed attempts are also retained.

## 2026-08-08T10:00:00Z | analyst | inspect-signature - action: inspect frontend bundle - command_or_ref: browser devtools / app.js - result_summary: signature entry located; dynamic nonce source unresolved - artifacts: [notes/app-js-call-chain.md] - evidence_ids: [E-001] - next: trace nonce generator without leaving in_scope host
06

AI: Automatically append Evidence

The AI records observation time, source, recurrence command, original excerpt, severity, and status and does not just output untraceable conclusions.

Set-Content -Path "work/demo-js-signature/notes/E-001-excerpt.txt" -Value "signature() calls buildNonce() before request dispatch" powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/append-evidence.ps1 ` -CaseRoot "work/demo-js-signature" ` -Id "E-001" ` -Title "Request signature call chain observed" ` -ReproCommand "Open app.js and trace signature() call sites" ` -Severity "info" ` -Status "observed" ` -RawExcerptFile "work/demo-js-signature/notes/E-001-excerpt.txt"
generate evidence/E-001.md, updated at the same time evidence/INDEX.md. Special characters or multi-line content are used first -RawExcerptFile, to avoid command line quotes from corrupting fields.
07

AI: From Evidence to Finding

AI only promotes conclusions that reference one or more Evidence IDs to Findings, describing impact, confidence, scope, and validation status.

StatusmeaningCan you enter the report?
observedThe original phenomenon has been documented but has not yet been fully explainedIt can be used as evidence and does not directly draw conclusions about loopholes.
candidateThere are reasonable assumptions that still need to be reproduced or eliminated.Can only be marked "to be verified"
validatedStable reproduction within Scope with evidence chainCan enter formal Finding
false_positivehas been proven to be untenableKeep audit records and avoid risks of inaction
08

AI: Automatically run read-only Case Review

AI automatically performs strict and hash verification before delivery; the reviewer only reads the Case and does not rewrite the original evidence. Any errors are blocking items.

#Look at the human readable results first python3 skills/case-review/scripts/review_case.py work/demo-js-signature --format markdown # Strict inspection and hash verification before delivery python3 skills/case-review/scripts/review_case.py work/demo-js-signature --verify-hashes --strict
Scope, Timeline, Work Item, Evidence, and Finding Path all pass; strict mode exit code is 0. Windows If the command name is python, can be python3 Replaced with the Python 3 path recorded in the index.
09

AI: Generate reports and accumulate experience

AI writes formal report report/, including scope, methods, evidence citations, Finding, limitations and repair suggestions; only desensitized and reusable experiences are written into the field-journal.

// TASK EXAMPLES

Three complete example paths

These examples show how AI will automatically route, initialize, and review tasks after receiving authorization, rather than requiring users to copy terminal commands. Users only need to provide real assets, authorization basis, allowed scope and delivery targets.

The user enters a task and the AI executes the process.Tables and commands are used to interpret automation results, audit AI behavior, and locate faults; no manual action is required unless the AI explicitly requests assistance due to permissions or licenses.

Example A: Own APK offline analysisNetwork mode offline · No packets are sent out.

target./samples/app.apkConfirm file ownership and hash, original file is saved read-only
expected routeR1 → apk-reverseKeywords include APK / jadx / smali
allowUnpacking, static analysis, local simulationIf you need a real Hook, add the equipment Scope separately.
prohibitedPublic network request and modify original samplesOutput into Case evidence / notes
sha256sum ./samples/app.apk bash skills/scripts/master-route.sh --hint "Own APK jadx smali static analysis" bash skills/scripts/case-init.sh --hint "Static analysis of own APK" --case-name apk-local-001 --preset offline-sample --sample ./samples/app.apk bash skills/scripts/case-guard.sh --case-root work/apk-local-001
Open only after Guard passes skills/apk-reverse/SKILL.md. All toolpaths start from tool-index.md Obtain; if jadx is missing, bootstrap again.

Example B: Isolating a Web RangeNetwork mode lab_only · Lab assets only

targethttp://10.10.10.20/Example address; confirm that it belongs to the isolation experimental network before actual use.
expected routepentest-tools Or more specifically Web SkillSubject to task semantics, no tools are required to be specified
allowVerification of limited ports and ratesSpecify timeout, concurrency, and time window in Scope
prohibitedBeyond the experimental network, DoS, real credential attacksStop immediately if out-of-border assets are discovered
bash skills/scripts/case-init.sh \ --hint "Isolated Lab Web Security Verification" \ --case-name "lab-web-001" \ --preset own-system \ --target-url "http://10.10.10.20/" \ --network-profile "lab_only" bash skills/scripts/case-guard.sh --case-root work/lab-web-001
scope.md Assets can only contain lab addresses, and the network mode is lab_only. Any scan parameters should be written into the work item before execution.

Example C: Read-only handover review of existing CaseNo access to target · No modification of evidence

python3 skills/case-review/scripts/review_case.py work/case-001 --format markdown python3 skills/case-review/scripts/review_case.py work/case-001 --verify-hashes --strict python3 skills/case-review/scripts/review_case.py work/case-001 --format json
Process first scope.* Error, then handle Evidence / Finding Path; warning can be explained but must be stated in the delivery record, error must be cleared.

How to Write a Qualifying Task Prompt

Assets and Attribution: <Local File/Lab URL/Written Authorization Target> Authorization evidence: <work order, contract, competition page, proof of ownership> Allowed actions: <static analysis, replay, limited verification, etc.> Prohibited actions: <DoS, unauthorized assets, real user data, etc.> Network mode: offline/lab_only/authorized_target_only Expected delivery: Evidence, Finding, Reproduction, Repair Suggestions, Report
Tips for writing:Clarify "target ownership/authorization source/permitted scope/prohibited actions/expected output". When there is insufficient information, the Agent should stop at the planning stage and complete the Scope.
// VERIFICATION

AI automatic verification

Ordinary users do not need to manually run complete tests when using only the warehouse. AI modification routing.json, scripts, Skill indexes or supply chain lists, they must automatically verify and repair failures in the following order, and then report the results to the user.

AI automates execution on Windows

# 163 routes return powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/test-routing.ps1 # Structural consistency + supply chain pin gate powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/verify-routing-coherence.ps1 # Smoke and INDEX drift checks powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/smoke.ps1 powershell -NoProfile -ExecutionPolicy Bypass -File skills/scripts/extract-summaries.ps1 -Check

AI automatically executes in PowerShell environments such as Ubuntu CI

pwsh -NoProfile -File skills/scripts/test-routing.ps1 pwsh -NoProfile -File skills/scripts/verify-routing-coherence.ps1 pwsh -NoProfile -File skills/scripts/smoke.ps1 pwsh -NoProfile -File skills/scripts/extract-summaries.ps1 -Check
CheckVerify contentLook first when you fail
test-routing163 Hints map to expected PRIMARYFailed use cases, priority, keywords must / exclude
verify-coherenceroutes/priority, Skill path, supply chain pin, authorization referenceNumber one BAD; don’t bypass the pin gate
smokeScript analysis and Chinese and English fast routing examplesMissing files, PowerShell parsing errors
extract-summariesWhether INDEX.md is synchronized with Skill summaryRegenerate first, then check the actual differences
  • Routing returns 163 / 163
  • Structural consistency and supply chain version fixed passed
  • Script parsing, fast routing and INDEX checks passed
  • Windows and Ubuntu CI results are consistent
Minimum rules for routing changes:Modify only skills/config/routing.json, not in master-route.ps1 or master-route.sh Rewrite a hard-coded routing table. When adding new rules, regression use cases will also be added.
// TROUBLESHOOTING

FAQ

Do I need to manually execute the commands on the tutorial page?

Not required under normal circumstances.Users simply ask the AI to read it in full README_AI.md, and then provide authorization tasks. The commands on the page are used to demonstrate the process automatically executed by AI and facilitate auditing and troubleshooting; only permissions, credentials, commercial licenses, or external side effects must be confirmed by the user.

Why do antivirus software or EDR report certain files as Trojans, backdoors or hacking tools?

This project is oriented to authorization security research, including reverse engineering, Hook/debugging, scanning, unpacking, vulnerability verification, CTF method and tool bootstrapping, etc. Security products often use keywords, static features, and behavioral heuristics for detection; these research logics may share local features with malicious samples and therefore produce false positives.However, the detection results cannot be automatically treated as false positives.

The correct approach is: only obtain it from the official repository or Release; check the version, submission source and SHA-256; review the hit files and recent differences; run in an isolated virtual machine or sandbox with minimal permissions and a restricted network. Do not add the entire project directory directly to the whitelist. If you find binaries from unknown sources, unexpected networking, credential reading, persistent startup items, hash inconsistencies, or behavior beyond the scope, you should stop immediately and handle it as a real security incident.

AI can assist in calculating hashes, interpreting scripts, and reviewing differences, but it cannot bypass organizational policies for users. When reporting false positives, please provide the security software name, detection label, relative path, SHA-256, project version and download source; do not upload company code, real samples, credentials or other sensitive files.

Which one should I choose between stable version v1.0.1 and main?

Select when you just want stable use v1.0.1;Choose when you need the latest fixes and are willing to follow mainline changes main. Regardless of which version you choose, do not directly overwrite updates in a workspace that has unconfirmed local modifications.

Do I need to regenerate the tool index after updating the warehouse?

Required, but automatically refreshed by AI. Updates may add tool definitions, candidate paths, or bootstrap hints; the AI should rerun the current platform's refresh script and report the results.

What should I do if the AI does not automatically route and starts guessing commands directly?

Immediately stop the target's actions. ask it to reread README_AI.mdRULES.md with skills/MASTER-ROUTING.md, run master-route and first report the PRIMARY, confidence, Scope plan and required tools.

What should I do if tool-index.md does not exist?

This is a normal first run state. AI finished reading README_AI.md You must first run the refresh script of the current platform to generate two indexes, Markdown and JSON; users do not need to generate them manually.

The index says the tool does not exist, but I just installed it. What should I do?

Tell the AI tool that something just changed. The AI will re-refresh the index and check candidate paths; if still not found, it should report the detection process instead of asking the user to fake "installed".

What if I'm missing jadx, Frida or other tools?

AI only automatically runs bootstrap for the Required tools of the current PRIMARY Skill, and then refreshes the index after the installation is complete. Commercial tools follow manualInstallHint and license requirements, and the AI only asks the user when a license or administrator rights are required.

What should I do if Bash routing prompts Python 3 required?

AI should recognize master-route.sh Requires Python 3, check if it can be safely installed automatically and verify python3 --version;Cannot be changed to another hard-coded Shell route.

What should I do if PowerShell prompts that script execution is blocked by system policy?

AI can use process-level -ExecutionPolicy Bypass form, the policy should not permanently degrade the entire machine. When blocked by enterprise policy, the AI should explain the blocking and request an administrator to handle it.

What should I do if the routing result is R0 or confidence=low?

The user can just add "target type + intention + key technology"; the AI will automatically rerun. Still blurry, AI turns on skills/routing.md Full Matrix selection and documentation of rationale in Case timeline.

Why does Case Guard return exit code 2?

AI reads every error entry: common reasons are auth.status is not granted, network mode is missing, non-offline Case has no assets, or ready_for_act Not true. AI correction can determine the field and confirm the real authorization to the user before re-running; it cannot be bypassed with Force.

Why is ready_for_act still false in Windows offline samples?

The PowerShell entry is conservative by default to offline. AI confirms the sample ownership, local file path, prohibited external connections, and out_of_scope to the user, updates the Scope, and then automatically runs Case Guard; the user does not need to edit manually. Bash can be used by AI --preset offline-sample --sample ...

What should I do if the strict mode of Case Review fails?

AI processes in order: Scope error → Missing timeline/workitems/evidence → Finding without evidence reference → Inconsistent hash. It cannot modify the original evidence in order to pass review; it adds evidence and records supersedes relationships when corrections are needed.

Is it safe to reuse the same CaseName?

Not recommended. AI should generate a unique CaseName for each new task; when it needs to be continued, append timeline, work item, and evidence to the original Case to avoid overwriting the previous structure.

Can I bind only one AI client?

You can write optional adaptations for a client, but you can't make the core depend on it. Do not change when migrating clients routing.json, Scope Contracts and Tests; only changes how the client loads project directives or skills.

Why do process commands still have the COPY button?

It only facilitates developers to audit, reproduce and troubleshoot, and does not mean that ordinary users must perform it manually. SELECT appears when some browsers block the clipboard; this does not affect the AI automation process.