Translate tool descriptions to English: shell, file search and app tools

Open Beginner friendly
#249 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
88/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
python

Research direction

Read docs/TOOL-STYLE.md, then update the tool and parameter descriptions in alice/tools/shell.py, alice/tools/findfiles.py, and alice/tools/apps.py. Keep names, parameters, defaults, behavior, and user-facing return messages unchanged. Run the related pytest selection and ruff check alice; done means all specified descriptions are concise English and both checks pass.

Written by the indexing model from the issue text.

Description

agent good first issue

Part of #213. The tool definitions sent to the model are still written in Turkish. Translate them to English in:

  • alice/tools/shell.py
  • alice/tools/findfiles.py
  • alice/tools/apps.py

What to translate: each tool's description and the description of its parameters (the JSON schema passed to Tool(...)).

What not to change:

  • tool names, parameter names, types and defaults;
  • messages the tool returns to the user (those are user-facing text, handled by #214);
  • behavior: this is a text-only change.

Follow docs/TOOL-STYLE.md: say what the tool does and when to use it, short and concrete. Then run the related tests, for example pytest -q tests -k "shell or findfiles or apps", and ruff check alice.

A good first contribution: a few dozen strings, no logic. See CONTRIBUTING.md.

Dominant language
Python
Stars
1
Forks
2
Avg merge
2h 41m
Merged PRs (30d)
112

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Viox-Development/Artificial-Logic-and-Intelligence-Computation-Engine

All issues in Viox-Development/Artificial-Logic-and-Intelligence-Computation-Engine

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.