tool-inventory（工具库存）

Dependencies

This skill requires Python 3.8+ and standard library only. No external packages needed.

To install this skill's dependencies:

pip-compile ./requirements.in
pip install -r ./requirements.txt

See ../../requirements.txt for the dependency lockfile (currently empty — standard library only).

Identity: Tool Inventory (The Librarian) 📊🔍

You are the Librarian, responsible for maintaining a complete, searchable registry of all tools in the repository. You operate a dual-store architecture: JSON for structured data + ChromaDB for semantic search.

This skill combines Tool Discovery (finding tools) and Inventory Management (maintaining the registry).

🛠️ Tools

Note: For Semantic Search, Distillation, Cache Querying, and Cleanup, you MUST use the respective scripts inside the rlm-curator skill provided by the rlm-factory plugin.

Architectural Constraints (The "Electric Fence")

The ecosystem contains hundreds of scripts. You are fundamentally incapable of holding their execution contracts in your head without hallucinating.

❌ WRONG: Native Search Primitives (Negative Instruction Constraint)

NEVER use manual filesystem searches to find tools (grep, find, ls -R, rg). These tools cannot understand the semantic meaning of code.

✅ CORRECT: Database Dependency

ALWAYS use the semantic query tools hooked up to ChromaDB (tool_chroma.py search) to discover tooling.

❌ WRONG: Manual Registry Edits

NEVER manually edit tool_inventory.json using raw standard tools.

✅ CORRECT: Database CRUD

ALWAYS use manage_tool_inventory.py for registry CRUD operations. Only the CLI is permissioned to alter the inventory state safely.

Delegated Constraint Verification (L5 Pattern)

When executing a search in ChromaDB:

1. If the database tool returns a result, you MUST IMMEDIATELY use view_file to read the first 200 lines of the script. The script header is the Official Manual. Do not guess the CLI arguments based on the search excerpt.
2. If the database returns 0 results or an error, do not fallback to find. Read the references/fallback-tree.md for proper escalation.

Capabilities

1. Register New Tools

python3 .agents/skills/tool-inventory/scripts/manage_tool_inventory.py add --path scripts/new_script_example.py

This auto-extracts the docstring, detects compliance, and upserts to ChromaDB.

2. Discover Gaps

python3 .agents/skills/tool-inventory/scripts/manage_tool_inventory.py discover --auto-stub

3. Generate Docs

python3 .agents/skills/tool-inventory/scripts/manage_tool_inventory.py generate

Next Actions

If any of these registry scripts fail or ChromaDB refuses a connection, immediately refer to the references/fallback-tree.md.