菜单
Navigate the genai-tk repository by mapping docs to code, config, tests, and existing skills. Use before making cross-cutting changes or when deciding which domain skill to load.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Build or modify LangChain, DeepAgent, DeerFlow profiles, agent tools, middleware, checkpointing, skills wiring, and the shared harness layer in genai-tk.
Work on BAML structured extraction, BAML CLI commands, processors, utilities, and Prefect BAML workflow integration in genai-tk.
Work on browser automation, sandbox browser tools, direct Playwright tools, AioSandbox backend, and sandbox CLI support in genai-tk.
Add or modify genai-tk Typer CLI commands, dynamic command registration, project scaffolding, and generated Copilot/agent support files.
Work on genai-tk OmegaConf configuration, profiles, overrides, env substitution, and config discovery. Use when editing config/*.yaml or genai_tk.config_mgmt.config_mngr.
Work on core LLM, embeddings, vector store, provider, cache, prompt, and retriever factories in genai-tk. Use when editing genai_tk/core or provider configuration.
| name | repo-map |
| description | Navigate the genai-tk repository by mapping docs to code, config, tests, and existing skills. Use before making cross-cutting changes or when deciding which domain skill to load. |
Read the closest doc first, then inspect the matching implementation paths. Do not infer behavior from filenames alone; this repo is configuration-driven and docs are the intended navigation layer.
| Work area | Read first | Then inspect |
|---|---|---|
| CLI commands | docs/cli.md, docs/scaffolding.md | genai_tk/main/cli.py, genai_tk/cli/, genai_tk/main/scaffolder.py, config/app_conf.yaml |
| Configuration | docs/configuration.md | genai_tk/utils/config_mngr.py, genai_tk/utils/config_exceptions.py, config/**/*.yaml |
| LLMs, embeddings, cache | docs/core.md, docs/llm-selection.md | genai_tk/core/, config/providers/, tests/unit_tests/core/ |
| Agents | docs/agents.md, docs/deer-flow.md | genai_tk/agents/, config/agents/, tests/unit_tests/agents/ |
| Agent middleware | docs/middleware-pii-and-routing.md | genai_tk/agents/langchain/middleware/, tests/unit_tests/agents/langchain/middleware/ |
| RAG | docs/rag.md | genai_tk/core/retrievers/, genai_tk/workflow/rag/, config/rag.yaml, tests/unit_tests/core/test_retriever_factory.py |
| Workflows and Prefect | docs/workflows.md, docs/prefect.md | genai_tk/workflow/, genai_tk/workflow/prefect/, config/workflows.yaml |
| MCP exposure | docs/mcp-servers.md | genai_tk/mcp/, config/examples/tk_servers.yaml, tests/unit_tests/mcp/ |
| Browser automation | docs/browser_control.md, docs/sandbox_support.md | genai_tk/agents/tools/sandbox_browser/, genai_tk/agents/tools/direct_browser/, genai_tk/agents/sandbox/ |
| Webapp | docs/webapp.md | genai_tk/webapp/, config/webapp.yaml |
| BAML | docs/baml.md | genai_tk/extra/structured/, genai_tk/workflow/prefect/flows/baml_flow.py |
| Evaluation/testing | docs/TESTING_GUIDE.md, docs/evaluation_testing.md | tests/, pyproject.toml dependency groups |
genai_tk.*.uv run ... for commands and tests.tests/unit_tests/<domain>/ path first; use integration tests only when behavior requires real services or CLI wiring.uv run pytest tests/unit_tests/core -q
uv run pytest tests/unit_tests/agents -q
uv run pytest tests/unit_tests/workflow -q
uv run pytest tests/unit_tests/mcp -q
uv run pytest tests/unit_tests/cli -q
Run make lint before finishing code changes that touch Python.