mirror of
https://github.com/Abdess/retroarch_system.git
synced 2026-11-13 05:23:51 -06:00
docs: name every refused quote in the agent steps
The skill and llms.txt said "a quote" where the tool refuses the typographic ones too, which end a PowerShell string. One constant states the set for both, and points to device_setup_command.
This commit is contained in:
1 parent
74489a4a0f
commit
268c974e28
2 files changed
+16
-6
No files matched your search
@@ -23,6 +23,13 @@ SITE = "https://abdess.github.io/retrobios/"
|
||||
PUBLISHER = "abdess.github.io"
|
||||
SH = "curl -fsSL https://abdess.github.io/retrobios/i | sh -s --"
|
||||
PS = "& ([scriptblock]::Create((irm https://abdess.github.io/retrobios/i.ps1)))"
|
||||
# What a folder put into a command may not hold, as agent-tools.ts refuses
|
||||
# it: PowerShell also ends a single-quoted string on the typographic quotes.
|
||||
REFUSED = "any quote, straight or typographic (' \" ‘ ’ ‚ ‛ “ ” „), a backtick or a control character"
|
||||
QUOTING = (f"A folder goes in single quotes, attached to its option. One that holds {REFUSED}, "
|
||||
"or starts with `-`, is a question for the user, never a value to escape into the "
|
||||
"command. On a page of the site, the `device_setup_command` WebMCP tool writes the "
|
||||
"command and refuses such a folder.")
|
||||
|
||||
START_PAGES = (
|
||||
("Which pack do I need", "which-pack/", "pick a device or setup, get the folder its BIOS files go in, "
|
||||
@@ -91,9 +98,7 @@ def llms_txt(platforms: list[tuple[str, str]]) -> str:
|
||||
"- From a computer, if the card is not found, name its BIOS folder: `--dest='<card>/bios'` "
|
||||
"(ArkOS and dArkOS: the `bios` folder of the EASYROMS part).",
|
||||
"- A games folder somewhere else: `--for-games='<folder>'`, one subfolder per system.",
|
||||
"- A folder goes in single quotes, attached to its option. One that holds a quote, a "
|
||||
"backtick or a control character, or starts with `-`, is a question for the user, never "
|
||||
"a value to escape into the command.",
|
||||
f"- {QUOTING}",
|
||||
"- Later, to see what is missing or wrong: `--check`. Machine-readable progress: "
|
||||
"`--events` (JSON lines, one per event, documented on the installer page).",
|
||||
"- A game the installer cannot identify gets every BIOS of its system, and the run names it.",
|
||||
@@ -159,9 +164,7 @@ def skill_md() -> str:
|
||||
"- Games outside the card: `--for-games='<folder>'`, one subfolder per system.",
|
||||
"- A setup not detected: `--platform=<name>`, a name exactly as `--list-platforms` prints "
|
||||
"it (letters, digits, `-` and `_`).",
|
||||
"- Put a folder in single quotes, attached to its option. If it holds a quote, a backtick "
|
||||
"or a control character, or starts with `-`, stop and ask the user: never escape it into "
|
||||
"the command.",
|
||||
f"- {QUOTING}",
|
||||
"",
|
||||
"## Later",
|
||||
"",
|
||||
|
||||
@@ -74,6 +74,13 @@ class TheSkillIsAnAgentSkill(unittest.TestCase):
|
||||
self.assertIn("--dest='<card>/bios'", text)
|
||||
self.assertIn("--for-games='<folder>'", text)
|
||||
self.assertIn("starts with `-`", text)
|
||||
# The characters agent-tools.ts refuses, typographic quotes included.
|
||||
# The backtick is named in words: Markdown would read it.
|
||||
self.assertIn("a backtick", siteagents.REFUSED)
|
||||
for char in "'\"‘’‚‛“”„":
|
||||
self.assertIn(char, siteagents.REFUSED)
|
||||
self.assertIn(char, TOOLS.read_text(encoding="utf-8"))
|
||||
self.assertIn(siteagents.REFUSED, text)
|
||||
|
||||
def test_the_manifest_types_it_as_a_skill(self) -> None:
|
||||
skill = siteagents.ard_manifest()["entries"][0]
|
||||
|
||||
Reference in new issue
Block a user