From 15c9e6006be2ad3c75bf084eef62bf9f634b6a22 Mon Sep 17 00:00:00 2001 From: Chinesezjc Date: Mon, 26 Oct 2026 11:26:05 +0800 Subject: [PATCH 1/7] fix(prompt): name line ranges and shell readers in the read guidance Restore the 2026-10-13 wording removed together with a later prompt revert: sed, head, and tail join cat as shell commands the read tool replaces, and offset/limit now describes reading a line range. The unit expectation for the rendered guidance follows. --- packages/fs/tool-fs/src/read.ts | 2 +- packages/fs/tool-fs/tests/tools.spec.ts | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/packages/fs/tool-fs/src/read.ts b/packages/fs/tool-fs/src/read.ts index a5a747c776..22c2dc52c9 100644 --- a/packages/fs/tool-fs/src/read.ts +++ b/packages/fs/tool-fs/src/read.ts @@ -71,7 +71,7 @@ export function applyReadTool(ctx: Context, caps: ReadToolCaps): void { order: ctx.systemPrompt.getSectionOrder('TOOL_READ'), text: ({ scope }) => ctx.tools.get('read', scope) === undefined ? '' - : 'Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.', + : 'Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.', }) ctx.tools.register(defineTool({ diff --git a/packages/fs/tool-fs/tests/tools.spec.ts b/packages/fs/tool-fs/tests/tools.spec.ts index 1f2c83d951..1d28251bd8 100644 --- a/packages/fs/tool-fs/tests/tools.spec.ts +++ b/packages/fs/tool-fs/tests/tools.spec.ts @@ -1077,7 +1077,7 @@ async function guidanceScope(ctx: Context) { } const originalGuidance = { - read: 'Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files.', + read: 'Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.', write: 'Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes.', edit: 'Read a file before editing it (the default fs-observation-policy requires it), unless you just created or edited it in this session.', } From c74015c81e35bc2d87e57e7af3e07b0f48554eee Mon Sep 17 00:00:00 2001 From: Chinesezjc Date: Mon, 26 Oct 2026 11:26:43 +0800 Subject: [PATCH 2/7] test(snapshot): re-render expected prompts and the read guidance fence 89 recorded system prompts carry the restored sentence; the two pinned historical sidecars keep their recorded text. The package README fence is updated in both languages. --- packages/fs/tool-fs/README.md | 2 +- packages/fs/tool-fs/README.zh.md | 2 +- .../sdk/background-wait-steer/system-prompt.expected.md | 2 +- snapshots/sdk/bash-tool/system-prompt.expected.md | 2 +- snapshots/sdk/desktop-context/system-prompt.expected.md | 2 +- snapshots/sdk/desktop-ptc-context/system-prompt.expected.md | 2 +- snapshots/sdk/session-resume/system-prompt.expected.md | 4 ++-- .../subagent-activation-limit/system-prompt.1.expected.md | 2 +- .../system-prompt.1.expected.md | 2 +- .../sdk/subagent-continuable/system-prompt.1.expected.md | 2 +- .../subagent-dsh-sdk-diagnostic/system-prompt.expected.md | 2 +- .../system-prompt.1.expected.md | 2 +- .../system-prompt.expected.md | 2 +- .../sdk/subagent-list-agents/system-prompt.1.expected.md | 2 +- .../sdk/subagent-send-message/system-prompt.1.expected.md | 2 +- snapshots/sdk/text-turn/system-prompt.expected.md | 2 +- snapshots/sdk/tool-error-details/system-prompt.expected.md | 4 ++-- .../session/advanced-toolchain/system-prompt.1.expected.md | 2 +- .../session/advanced-toolchain/system-prompt.2.expected.md | 2 +- .../session/advanced-toolchain/system-prompt.expected.md | 6 +++--- .../session/agent-instructions/system-prompt.expected.md | 2 +- .../system-prompt.expected.md | 2 +- snapshots/session/both-mode-turn/system-prompt.expected.md | 2 +- .../system-prompt.expected.md | 2 +- .../browser-use-playwright-mcp/system-prompt.expected.md | 2 +- .../browser-use-stagehand-native/system-prompt.expected.md | 2 +- .../session/claude-code-mods/system-prompt.expected.md | 2 +- .../session/compaction-recovery/system-prompt.expected.md | 2 +- .../computer-use-cua-driver-mcp/system-prompt.expected.md | 2 +- .../system-prompt.expected.md | 2 +- .../session/cordis-inspect-jsdoc/system-prompt.expected.md | 2 +- snapshots/session/cua-native/system-prompt.expected.md | 2 +- snapshots/session/cua-ptc/system-prompt.expected.md | 2 +- .../system-prompt.expected.md | 4 ++-- .../system-prompt.expected.md | 4 ++-- .../dynamic-tool-prompt-updates/system-prompt.expected.md | 4 ++-- .../session/dynamic-tool-updates/system-prompt.expected.md | 2 +- .../system-prompt.expected.md | 2 +- .../session/fs-glob-sampling/system-prompt.expected.md | 2 +- .../in-history-series-start/system-prompt.expected.md | 4 ++-- snapshots/session/lsp-definition/system-prompt.expected.md | 2 +- .../session/mcp-resources-ptc/system-prompt.expected.md | 2 +- snapshots/session/mcp-resources/system-prompt.expected.md | 2 +- .../model-switch-compaction/system-prompt.expected.md | 4 ++-- .../session/model-switch-notice/system-prompt.expected.md | 4 ++-- .../session/multimodal-spill-ends/system-prompt.expected.md | 2 +- .../office-authoring-checker/system-prompt.expected.md | 2 +- .../office-progressive-native/system-prompt.expected.md | 2 +- .../office-progressive-ptc/system-prompt.expected.md | 2 +- .../office-sidecar-instructions/system-prompt.expected.md | 2 +- snapshots/session/office-skills/system-prompt.expected.md | 2 +- .../persistent-pwsh-tool-turn/system-prompt.expected.md | 2 +- .../pi-ai-conversation-updates/system-prompt.expected.md | 4 ++-- .../session/plugin-manager-mcp/system-prompt.expected.md | 4 ++-- snapshots/session/plugin-manager/system-prompt.expected.md | 2 +- .../session/product-subagent-both/system-prompt.expected.md | 2 +- .../product-subagent-codex/system-prompt.expected.md | 2 +- .../session/product-subagent-oar/system-prompt.expected.md | 2 +- .../system-prompt.expected.md | 2 +- snapshots/session/provider-cwd/system-prompt.expected.md | 2 +- .../session/ptc-node-read-only/system-prompt.expected.md | 2 +- .../session/ptc-node-workspace/system-prompt.expected.md | 2 +- snapshots/session/ptc-persistent/system-prompt.expected.md | 2 +- .../session/ptc-policy-change/system-prompt.expected.md | 2 +- snapshots/session/ptc-python-turn/system-prompt.expected.md | 2 +- snapshots/session/ptc-read-image/system-prompt.expected.md | 2 +- snapshots/session/ptc-turn/system-prompt.expected.md | 2 +- .../pty-tools-sandbox-backend/system-prompt.expected.md | 2 +- snapshots/session/pwsh-tool-turn/system-prompt.expected.md | 2 +- snapshots/session/ralph-loop/system-prompt.1.expected.md | 2 +- snapshots/session/ralph-loop/system-prompt.2.expected.md | 2 +- snapshots/session/ralph-loop/system-prompt.expected.md | 2 +- snapshots/session/read-image/system-prompt.expected.md | 2 +- .../session/session-query-spill/system-prompt.expected.md | 2 +- .../subagent-acp-diagnostic/system-prompt.expected.md | 2 +- .../subagent-agent-preset/system-prompt.1.expected.md | 2 +- .../subagent-structured-parent/system-prompt.1.expected.md | 2 +- .../system-prompt-in-history/system-prompt.expected.md | 4 ++-- snapshots/session/team-targets/system-prompt.expected.md | 2 +- snapshots/session/text-turn/system-prompt.expected.md | 2 +- snapshots/session/web-fetch/system-prompt.expected.md | 2 +- .../web-search-unconfigured/system-prompt.expected.md | 2 +- .../session/workflow-confinement/system-prompt.expected.md | 2 +- .../workspace-dependencies/system-prompt.expected.md | 2 +- snapshots/session/worktree/system-prompt.expected.md | 2 +- .../web/creation-recommendations/system-prompt.expected.md | 2 +- snapshots/web/fresh-round-trip/system-prompt.expected.md | 2 +- .../web/official-subagent-bundle/system-prompt.expected.md | 2 +- .../web/optional-string-editor/system-prompt.expected.md | 2 +- .../web/plugin-recommendations/system-prompt.expected.md | 2 +- snapshots/web/ptc-round/system-prompt.expected.md | 2 +- 91 files changed, 104 insertions(+), 104 deletions(-) diff --git a/packages/fs/tool-fs/README.md b/packages/fs/tool-fs/README.md index e6e2d27144..5e8ba11ffe 100644 --- a/packages/fs/tool-fs/README.md +++ b/packages/fs/tool-fs/README.md @@ -147,7 +147,7 @@ At assembly time, each guidance section checks `ctx.tools.get(name, scope)` and ##### Read guidance ```markdown -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. ``` ##### Write guidance diff --git a/packages/fs/tool-fs/README.zh.md b/packages/fs/tool-fs/README.zh.md index 82b68d2fe0..d7b3eab61f 100644 --- a/packages/fs/tool-fs/README.zh.md +++ b/packages/fs/tool-fs/README.zh.md @@ -147,7 +147,7 @@ kind: "package-reference" ##### Read 指导 ```markdown -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. ``` ##### Write 指导 diff --git a/snapshots/sdk/background-wait-steer/system-prompt.expected.md b/snapshots/sdk/background-wait-steer/system-prompt.expected.md index 86a2cff4e4..c2439536ef 100644 --- a/snapshots/sdk/background-wait-steer/system-prompt.expected.md +++ b/snapshots/sdk/background-wait-steer/system-prompt.expected.md @@ -6,7 +6,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/sdk/bash-tool/system-prompt.expected.md b/snapshots/sdk/bash-tool/system-prompt.expected.md index 6288c22387..9d6dac39d5 100644 --- a/snapshots/sdk/bash-tool/system-prompt.expected.md +++ b/snapshots/sdk/bash-tool/system-prompt.expected.md @@ -4,7 +4,7 @@ You are a coding agent powered by the deepseek-v4-flash model. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/sdk/desktop-context/system-prompt.expected.md b/snapshots/sdk/desktop-context/system-prompt.expected.md index 86a2cff4e4..c2439536ef 100644 --- a/snapshots/sdk/desktop-context/system-prompt.expected.md +++ b/snapshots/sdk/desktop-context/system-prompt.expected.md @@ -6,7 +6,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/sdk/desktop-ptc-context/system-prompt.expected.md b/snapshots/sdk/desktop-ptc-context/system-prompt.expected.md index 69ace6433c..6a6ded0f71 100644 --- a/snapshots/sdk/desktop-ptc-context/system-prompt.expected.md +++ b/snapshots/sdk/desktop-ptc-context/system-prompt.expected.md @@ -8,7 +8,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/sdk/session-resume/system-prompt.expected.md b/snapshots/sdk/session-resume/system-prompt.expected.md index edee628694..ebfa6ae4cb 100644 --- a/snapshots/sdk/session-resume/system-prompt.expected.md +++ b/snapshots/sdk/session-resume/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -40,7 +40,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/sdk/subagent-activation-limit/system-prompt.1.expected.md b/snapshots/sdk/subagent-activation-limit/system-prompt.1.expected.md index 4129b103da..cfc9e19da9 100644 --- a/snapshots/sdk/subagent-activation-limit/system-prompt.1.expected.md +++ b/snapshots/sdk/subagent-activation-limit/system-prompt.1.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/sdk/subagent-continuable-inheritance/system-prompt.1.expected.md b/snapshots/sdk/subagent-continuable-inheritance/system-prompt.1.expected.md index 4129b103da..cfc9e19da9 100644 --- a/snapshots/sdk/subagent-continuable-inheritance/system-prompt.1.expected.md +++ b/snapshots/sdk/subagent-continuable-inheritance/system-prompt.1.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/sdk/subagent-continuable/system-prompt.1.expected.md b/snapshots/sdk/subagent-continuable/system-prompt.1.expected.md index 4129b103da..cfc9e19da9 100644 --- a/snapshots/sdk/subagent-continuable/system-prompt.1.expected.md +++ b/snapshots/sdk/subagent-continuable/system-prompt.1.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/sdk/subagent-dsh-sdk-diagnostic/system-prompt.expected.md b/snapshots/sdk/subagent-dsh-sdk-diagnostic/system-prompt.expected.md index 557223b560..19327b18a7 100644 --- a/snapshots/sdk/subagent-dsh-sdk-diagnostic/system-prompt.expected.md +++ b/snapshots/sdk/subagent-dsh-sdk-diagnostic/system-prompt.expected.md @@ -4,7 +4,7 @@ You are a coding agent powered by the deepseek-v4-flash model. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/sdk/subagent-dsh-sdk-dynamic-route/system-prompt.1.expected.md b/snapshots/sdk/subagent-dsh-sdk-dynamic-route/system-prompt.1.expected.md index 88216ca091..30fc27f25e 100644 --- a/snapshots/sdk/subagent-dsh-sdk-dynamic-route/system-prompt.1.expected.md +++ b/snapshots/sdk/subagent-dsh-sdk-dynamic-route/system-prompt.1.expected.md @@ -4,7 +4,7 @@ Echo where you run. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/sdk/subagent-dsh-sdk-dynamic-route/system-prompt.expected.md b/snapshots/sdk/subagent-dsh-sdk-dynamic-route/system-prompt.expected.md index 312d216243..19ed1747e3 100644 --- a/snapshots/sdk/subagent-dsh-sdk-dynamic-route/system-prompt.expected.md +++ b/snapshots/sdk/subagent-dsh-sdk-dynamic-route/system-prompt.expected.md @@ -4,7 +4,7 @@ You are a coding agent powered by the mock-delegate model. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/sdk/subagent-list-agents/system-prompt.1.expected.md b/snapshots/sdk/subagent-list-agents/system-prompt.1.expected.md index 4129b103da..cfc9e19da9 100644 --- a/snapshots/sdk/subagent-list-agents/system-prompt.1.expected.md +++ b/snapshots/sdk/subagent-list-agents/system-prompt.1.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/sdk/subagent-send-message/system-prompt.1.expected.md b/snapshots/sdk/subagent-send-message/system-prompt.1.expected.md index 4129b103da..cfc9e19da9 100644 --- a/snapshots/sdk/subagent-send-message/system-prompt.1.expected.md +++ b/snapshots/sdk/subagent-send-message/system-prompt.1.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/sdk/text-turn/system-prompt.expected.md b/snapshots/sdk/text-turn/system-prompt.expected.md index 6288c22387..9d6dac39d5 100644 --- a/snapshots/sdk/text-turn/system-prompt.expected.md +++ b/snapshots/sdk/text-turn/system-prompt.expected.md @@ -4,7 +4,7 @@ You are a coding agent powered by the deepseek-v4-flash model. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/sdk/tool-error-details/system-prompt.expected.md b/snapshots/sdk/tool-error-details/system-prompt.expected.md index aca0bd51a7..de964eee33 100644 --- a/snapshots/sdk/tool-error-details/system-prompt.expected.md +++ b/snapshots/sdk/tool-error-details/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -42,7 +42,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/advanced-toolchain/system-prompt.1.expected.md b/snapshots/session/advanced-toolchain/system-prompt.1.expected.md index c776c30451..96c21c3c36 100644 --- a/snapshots/session/advanced-toolchain/system-prompt.1.expected.md +++ b/snapshots/session/advanced-toolchain/system-prompt.1.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/advanced-toolchain/system-prompt.2.expected.md b/snapshots/session/advanced-toolchain/system-prompt.2.expected.md index c776c30451..96c21c3c36 100644 --- a/snapshots/session/advanced-toolchain/system-prompt.2.expected.md +++ b/snapshots/session/advanced-toolchain/system-prompt.2.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/advanced-toolchain/system-prompt.expected.md b/snapshots/session/advanced-toolchain/system-prompt.expected.md index 46dd5fe0a4..16c4ac1b27 100644 --- a/snapshots/session/advanced-toolchain/system-prompt.expected.md +++ b/snapshots/session/advanced-toolchain/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -42,7 +42,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -596,7 +596,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/agent-instructions/system-prompt.expected.md b/snapshots/session/agent-instructions/system-prompt.expected.md index c776c30451..96c21c3c36 100644 --- a/snapshots/session/agent-instructions/system-prompt.expected.md +++ b/snapshots/session/agent-instructions/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/background-confinement-failure/system-prompt.expected.md b/snapshots/session/background-confinement-failure/system-prompt.expected.md index 4129b103da..cfc9e19da9 100644 --- a/snapshots/session/background-confinement-failure/system-prompt.expected.md +++ b/snapshots/session/background-confinement-failure/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/both-mode-turn/system-prompt.expected.md b/snapshots/session/both-mode-turn/system-prompt.expected.md index ed5922ee4f..fd99e781df 100644 --- a/snapshots/session/both-mode-turn/system-prompt.expected.md +++ b/snapshots/session/both-mode-turn/system-prompt.expected.md @@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/browser-use-chrome-devtools-mcp/system-prompt.expected.md b/snapshots/session/browser-use-chrome-devtools-mcp/system-prompt.expected.md index c07f1a39fe..8fe493e37d 100644 --- a/snapshots/session/browser-use-chrome-devtools-mcp/system-prompt.expected.md +++ b/snapshots/session/browser-use-chrome-devtools-mcp/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/browser-use-playwright-mcp/system-prompt.expected.md b/snapshots/session/browser-use-playwright-mcp/system-prompt.expected.md index 63b5fb94fa..43813d6a9a 100644 --- a/snapshots/session/browser-use-playwright-mcp/system-prompt.expected.md +++ b/snapshots/session/browser-use-playwright-mcp/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/browser-use-stagehand-native/system-prompt.expected.md b/snapshots/session/browser-use-stagehand-native/system-prompt.expected.md index 2958e580fc..0eb0d56504 100644 --- a/snapshots/session/browser-use-stagehand-native/system-prompt.expected.md +++ b/snapshots/session/browser-use-stagehand-native/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/claude-code-mods/system-prompt.expected.md b/snapshots/session/claude-code-mods/system-prompt.expected.md index 4129b103da..cfc9e19da9 100644 --- a/snapshots/session/claude-code-mods/system-prompt.expected.md +++ b/snapshots/session/claude-code-mods/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/compaction-recovery/system-prompt.expected.md b/snapshots/session/compaction-recovery/system-prompt.expected.md index 4129b103da..cfc9e19da9 100644 --- a/snapshots/session/compaction-recovery/system-prompt.expected.md +++ b/snapshots/session/compaction-recovery/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/computer-use-cua-driver-mcp/system-prompt.expected.md b/snapshots/session/computer-use-cua-driver-mcp/system-prompt.expected.md index ec0feaa6d1..7c5cb56d21 100644 --- a/snapshots/session/computer-use-cua-driver-mcp/system-prompt.expected.md +++ b/snapshots/session/computer-use-cua-driver-mcp/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/computer-use-cua-driver-native/system-prompt.expected.md b/snapshots/session/computer-use-cua-driver-native/system-prompt.expected.md index b80574dac4..9da550bd3e 100644 --- a/snapshots/session/computer-use-cua-driver-native/system-prompt.expected.md +++ b/snapshots/session/computer-use-cua-driver-native/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/cordis-inspect-jsdoc/system-prompt.expected.md b/snapshots/session/cordis-inspect-jsdoc/system-prompt.expected.md index c776c30451..96c21c3c36 100644 --- a/snapshots/session/cordis-inspect-jsdoc/system-prompt.expected.md +++ b/snapshots/session/cordis-inspect-jsdoc/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/cua-native/system-prompt.expected.md b/snapshots/session/cua-native/system-prompt.expected.md index c842954b3b..b08a00dc92 100644 --- a/snapshots/session/cua-native/system-prompt.expected.md +++ b/snapshots/session/cua-native/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/cua-ptc/system-prompt.expected.md b/snapshots/session/cua-ptc/system-prompt.expected.md index 55611ceb34..f0677e6786 100644 --- a/snapshots/session/cua-ptc/system-prompt.expected.md +++ b/snapshots/session/cua-ptc/system-prompt.expected.md @@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/deepseek-messages-system-prompt/system-prompt.expected.md b/snapshots/session/deepseek-messages-system-prompt/system-prompt.expected.md index 0296cb556a..866544439b 100644 --- a/snapshots/session/deepseek-messages-system-prompt/system-prompt.expected.md +++ b/snapshots/session/deepseek-messages-system-prompt/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -42,7 +42,7 @@ Snapshot guidance added after the first read: reply with the single word DONE. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/deepseek-protocol-system-prompt/system-prompt.expected.md b/snapshots/session/deepseek-protocol-system-prompt/system-prompt.expected.md index 0296cb556a..866544439b 100644 --- a/snapshots/session/deepseek-protocol-system-prompt/system-prompt.expected.md +++ b/snapshots/session/deepseek-protocol-system-prompt/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -42,7 +42,7 @@ Snapshot guidance added after the first read: reply with the single word DONE. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/dynamic-tool-prompt-updates/system-prompt.expected.md b/snapshots/session/dynamic-tool-prompt-updates/system-prompt.expected.md index 86d12ea329..a05793a859 100644 --- a/snapshots/session/dynamic-tool-prompt-updates/system-prompt.expected.md +++ b/snapshots/session/dynamic-tool-prompt-updates/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -42,7 +42,7 @@ Dynamic tool guidance: call snapshot_ping once, then reply with the single word Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/dynamic-tool-updates/system-prompt.expected.md b/snapshots/session/dynamic-tool-updates/system-prompt.expected.md index 4129b103da..cfc9e19da9 100644 --- a/snapshots/session/dynamic-tool-updates/system-prompt.expected.md +++ b/snapshots/session/dynamic-tool-updates/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/foreground-confinement-timeout/system-prompt.expected.md b/snapshots/session/foreground-confinement-timeout/system-prompt.expected.md index 4129b103da..cfc9e19da9 100644 --- a/snapshots/session/foreground-confinement-timeout/system-prompt.expected.md +++ b/snapshots/session/foreground-confinement-timeout/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/fs-glob-sampling/system-prompt.expected.md b/snapshots/session/fs-glob-sampling/system-prompt.expected.md index 1b805eaf0c..d2353b3564 100644 --- a/snapshots/session/fs-glob-sampling/system-prompt.expected.md +++ b/snapshots/session/fs-glob-sampling/system-prompt.expected.md @@ -4,7 +4,7 @@ You are a concise snapshot agent. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/in-history-series-start/system-prompt.expected.md b/snapshots/session/in-history-series-start/system-prompt.expected.md index 560982974b..f1e2396301 100644 --- a/snapshots/session/in-history-series-start/system-prompt.expected.md +++ b/snapshots/session/in-history-series-start/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -42,7 +42,7 @@ Snapshot guidance added after the first read: call snapshot_ping once, then repl Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/lsp-definition/system-prompt.expected.md b/snapshots/session/lsp-definition/system-prompt.expected.md index 0283ccaab4..1f3292c0de 100644 --- a/snapshots/session/lsp-definition/system-prompt.expected.md +++ b/snapshots/session/lsp-definition/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/mcp-resources-ptc/system-prompt.expected.md b/snapshots/session/mcp-resources-ptc/system-prompt.expected.md index 47af8cdc91..6935afcb13 100644 --- a/snapshots/session/mcp-resources-ptc/system-prompt.expected.md +++ b/snapshots/session/mcp-resources-ptc/system-prompt.expected.md @@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/mcp-resources/system-prompt.expected.md b/snapshots/session/mcp-resources/system-prompt.expected.md index 275f98c89b..27a0d010fa 100644 --- a/snapshots/session/mcp-resources/system-prompt.expected.md +++ b/snapshots/session/mcp-resources/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/model-switch-compaction/system-prompt.expected.md b/snapshots/session/model-switch-compaction/system-prompt.expected.md index edee628694..ebfa6ae4cb 100644 --- a/snapshots/session/model-switch-compaction/system-prompt.expected.md +++ b/snapshots/session/model-switch-compaction/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -40,7 +40,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/model-switch-notice/system-prompt.expected.md b/snapshots/session/model-switch-notice/system-prompt.expected.md index edee628694..ebfa6ae4cb 100644 --- a/snapshots/session/model-switch-notice/system-prompt.expected.md +++ b/snapshots/session/model-switch-notice/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -40,7 +40,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/multimodal-spill-ends/system-prompt.expected.md b/snapshots/session/multimodal-spill-ends/system-prompt.expected.md index 4956076bc6..203482bcf8 100644 --- a/snapshots/session/multimodal-spill-ends/system-prompt.expected.md +++ b/snapshots/session/multimodal-spill-ends/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/office-authoring-checker/system-prompt.expected.md b/snapshots/session/office-authoring-checker/system-prompt.expected.md index fb8a26b762..99835b05a4 100644 --- a/snapshots/session/office-authoring-checker/system-prompt.expected.md +++ b/snapshots/session/office-authoring-checker/system-prompt.expected.md @@ -5,7 +5,7 @@ You are a coding assistant powered by the deepseek-v4-flash model. Your bash too Verify your work by running the code or tests. Keep answers brief and factual. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/office-progressive-native/system-prompt.expected.md b/snapshots/session/office-progressive-native/system-prompt.expected.md index fb8a26b762..99835b05a4 100644 --- a/snapshots/session/office-progressive-native/system-prompt.expected.md +++ b/snapshots/session/office-progressive-native/system-prompt.expected.md @@ -5,7 +5,7 @@ You are a coding assistant powered by the deepseek-v4-flash model. Your bash too Verify your work by running the code or tests. Keep answers brief and factual. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/office-progressive-ptc/system-prompt.expected.md b/snapshots/session/office-progressive-ptc/system-prompt.expected.md index 5a735d0ba4..7b8827164b 100644 --- a/snapshots/session/office-progressive-ptc/system-prompt.expected.md +++ b/snapshots/session/office-progressive-ptc/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. `run_code` is the only tool you can call directly — a tool call naming any other tool fails. Reach every tool the SDK declares below from inside the program. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/office-sidecar-instructions/system-prompt.expected.md b/snapshots/session/office-sidecar-instructions/system-prompt.expected.md index fb8a26b762..99835b05a4 100644 --- a/snapshots/session/office-sidecar-instructions/system-prompt.expected.md +++ b/snapshots/session/office-sidecar-instructions/system-prompt.expected.md @@ -5,7 +5,7 @@ You are a coding assistant powered by the deepseek-v4-flash model. Your bash too Verify your work by running the code or tests. Keep answers brief and factual. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/office-skills/system-prompt.expected.md b/snapshots/session/office-skills/system-prompt.expected.md index fb8a26b762..99835b05a4 100644 --- a/snapshots/session/office-skills/system-prompt.expected.md +++ b/snapshots/session/office-skills/system-prompt.expected.md @@ -5,7 +5,7 @@ You are a coding assistant powered by the deepseek-v4-flash model. Your bash too Verify your work by running the code or tests. Keep answers brief and factual. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/persistent-pwsh-tool-turn/system-prompt.expected.md b/snapshots/session/persistent-pwsh-tool-turn/system-prompt.expected.md index 842c2d65fe..87e4851cef 100644 --- a/snapshots/session/persistent-pwsh-tool-turn/system-prompt.expected.md +++ b/snapshots/session/persistent-pwsh-tool-turn/system-prompt.expected.md @@ -2,7 +2,7 @@ You are an AI agent powered by DeepSeek Harness. You are a concise snapshot agent. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/pi-ai-conversation-updates/system-prompt.expected.md b/snapshots/session/pi-ai-conversation-updates/system-prompt.expected.md index ae076cd46e..98e9aa7f18 100644 --- a/snapshots/session/pi-ai-conversation-updates/system-prompt.expected.md +++ b/snapshots/session/pi-ai-conversation-updates/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -42,7 +42,7 @@ Dynamic tool guidance: call snapshot_ping once, then reply with the single word Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/plugin-manager-mcp/system-prompt.expected.md b/snapshots/session/plugin-manager-mcp/system-prompt.expected.md index 738714e849..0100efe4af 100644 --- a/snapshots/session/plugin-manager-mcp/system-prompt.expected.md +++ b/snapshots/session/plugin-manager-mcp/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -40,7 +40,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/plugin-manager/system-prompt.expected.md b/snapshots/session/plugin-manager/system-prompt.expected.md index 4129b103da..cfc9e19da9 100644 --- a/snapshots/session/plugin-manager/system-prompt.expected.md +++ b/snapshots/session/plugin-manager/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/product-subagent-both/system-prompt.expected.md b/snapshots/session/product-subagent-both/system-prompt.expected.md index c56d93da7d..6d4a844eb5 100644 --- a/snapshots/session/product-subagent-both/system-prompt.expected.md +++ b/snapshots/session/product-subagent-both/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/product-subagent-codex/system-prompt.expected.md b/snapshots/session/product-subagent-codex/system-prompt.expected.md index 1d102aa047..821579815c 100644 --- a/snapshots/session/product-subagent-codex/system-prompt.expected.md +++ b/snapshots/session/product-subagent-codex/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/product-subagent-oar/system-prompt.expected.md b/snapshots/session/product-subagent-oar/system-prompt.expected.md index 1602145e6e..a968d842ef 100644 --- a/snapshots/session/product-subagent-oar/system-prompt.expected.md +++ b/snapshots/session/product-subagent-oar/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/product-subagent-result-diagnostic/system-prompt.expected.md b/snapshots/session/product-subagent-result-diagnostic/system-prompt.expected.md index f99fb3e50f..476ed70b23 100644 --- a/snapshots/session/product-subagent-result-diagnostic/system-prompt.expected.md +++ b/snapshots/session/product-subagent-result-diagnostic/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/provider-cwd/system-prompt.expected.md b/snapshots/session/provider-cwd/system-prompt.expected.md index 4129b103da..cfc9e19da9 100644 --- a/snapshots/session/provider-cwd/system-prompt.expected.md +++ b/snapshots/session/provider-cwd/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/ptc-node-read-only/system-prompt.expected.md b/snapshots/session/ptc-node-read-only/system-prompt.expected.md index 792433868b..9be58967e7 100644 --- a/snapshots/session/ptc-node-read-only/system-prompt.expected.md +++ b/snapshots/session/ptc-node-read-only/system-prompt.expected.md @@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/ptc-node-workspace/system-prompt.expected.md b/snapshots/session/ptc-node-workspace/system-prompt.expected.md index 792433868b..9be58967e7 100644 --- a/snapshots/session/ptc-node-workspace/system-prompt.expected.md +++ b/snapshots/session/ptc-node-workspace/system-prompt.expected.md @@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/ptc-persistent/system-prompt.expected.md b/snapshots/session/ptc-persistent/system-prompt.expected.md index cee1d38ca1..f78d20535d 100644 --- a/snapshots/session/ptc-persistent/system-prompt.expected.md +++ b/snapshots/session/ptc-persistent/system-prompt.expected.md @@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/ptc-policy-change/system-prompt.expected.md b/snapshots/session/ptc-policy-change/system-prompt.expected.md index 0299ece58d..980e98ffa4 100644 --- a/snapshots/session/ptc-policy-change/system-prompt.expected.md +++ b/snapshots/session/ptc-policy-change/system-prompt.expected.md @@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/ptc-python-turn/system-prompt.expected.md b/snapshots/session/ptc-python-turn/system-prompt.expected.md index 30de551e71..89537e68ab 100644 --- a/snapshots/session/ptc-python-turn/system-prompt.expected.md +++ b/snapshots/session/ptc-python-turn/system-prompt.expected.md @@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/ptc-read-image/system-prompt.expected.md b/snapshots/session/ptc-read-image/system-prompt.expected.md index 24a8c6d038..b2d28e5d8b 100644 --- a/snapshots/session/ptc-read-image/system-prompt.expected.md +++ b/snapshots/session/ptc-read-image/system-prompt.expected.md @@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/ptc-turn/system-prompt.expected.md b/snapshots/session/ptc-turn/system-prompt.expected.md index 792433868b..9be58967e7 100644 --- a/snapshots/session/ptc-turn/system-prompt.expected.md +++ b/snapshots/session/ptc-turn/system-prompt.expected.md @@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/pty-tools-sandbox-backend/system-prompt.expected.md b/snapshots/session/pty-tools-sandbox-backend/system-prompt.expected.md index 20152fd0c0..be57207fc0 100644 --- a/snapshots/session/pty-tools-sandbox-backend/system-prompt.expected.md +++ b/snapshots/session/pty-tools-sandbox-backend/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/pwsh-tool-turn/system-prompt.expected.md b/snapshots/session/pwsh-tool-turn/system-prompt.expected.md index d8b177d881..a80f28bb0b 100644 --- a/snapshots/session/pwsh-tool-turn/system-prompt.expected.md +++ b/snapshots/session/pwsh-tool-turn/system-prompt.expected.md @@ -4,7 +4,7 @@ You are a concise snapshot agent. Non-zero exits are reported as `[exit code: N]` markers; investigate failures before moving on. On Windows a killed process settles as `[exit code: 1]` without a signal marker; treat a bare exit 1 after an interruption as a termination, not a command failure. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/ralph-loop/system-prompt.1.expected.md b/snapshots/session/ralph-loop/system-prompt.1.expected.md index 5fbb332b1a..e6e23d12d1 100644 --- a/snapshots/session/ralph-loop/system-prompt.1.expected.md +++ b/snapshots/session/ralph-loop/system-prompt.1.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/ralph-loop/system-prompt.2.expected.md b/snapshots/session/ralph-loop/system-prompt.2.expected.md index 5fbb332b1a..e6e23d12d1 100644 --- a/snapshots/session/ralph-loop/system-prompt.2.expected.md +++ b/snapshots/session/ralph-loop/system-prompt.2.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/ralph-loop/system-prompt.expected.md b/snapshots/session/ralph-loop/system-prompt.expected.md index c660db009c..89df21339c 100644 --- a/snapshots/session/ralph-loop/system-prompt.expected.md +++ b/snapshots/session/ralph-loop/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/read-image/system-prompt.expected.md b/snapshots/session/read-image/system-prompt.expected.md index 4956076bc6..203482bcf8 100644 --- a/snapshots/session/read-image/system-prompt.expected.md +++ b/snapshots/session/read-image/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/session-query-spill/system-prompt.expected.md b/snapshots/session/session-query-spill/system-prompt.expected.md index 11134b52b8..57b51b4d63 100644 --- a/snapshots/session/session-query-spill/system-prompt.expected.md +++ b/snapshots/session/session-query-spill/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/subagent-acp-diagnostic/system-prompt.expected.md b/snapshots/session/subagent-acp-diagnostic/system-prompt.expected.md index e4447fa937..d6c0fe5ce3 100644 --- a/snapshots/session/subagent-acp-diagnostic/system-prompt.expected.md +++ b/snapshots/session/subagent-acp-diagnostic/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/subagent-agent-preset/system-prompt.1.expected.md b/snapshots/session/subagent-agent-preset/system-prompt.1.expected.md index 21ed8bf9ad..0871e4b88e 100644 --- a/snapshots/session/subagent-agent-preset/system-prompt.1.expected.md +++ b/snapshots/session/subagent-agent-preset/system-prompt.1.expected.md @@ -4,7 +4,7 @@ You are a file reviewer. Inspect the requested files and report your findings. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/subagent-structured-parent/system-prompt.1.expected.md b/snapshots/session/subagent-structured-parent/system-prompt.1.expected.md index 7cbbfb55ef..11e71560b8 100644 --- a/snapshots/session/subagent-structured-parent/system-prompt.1.expected.md +++ b/snapshots/session/subagent-structured-parent/system-prompt.1.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/system-prompt-in-history/system-prompt.expected.md b/snapshots/session/system-prompt-in-history/system-prompt.expected.md index 95c410e8ec..52bd312c90 100644 --- a/snapshots/session/system-prompt-in-history/system-prompt.expected.md +++ b/snapshots/session/system-prompt-in-history/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -42,7 +42,7 @@ Snapshot guidance added after the first read: reply with the single word DONE. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/team-targets/system-prompt.expected.md b/snapshots/session/team-targets/system-prompt.expected.md index ff7929a66a..6cebee7943 100644 --- a/snapshots/session/team-targets/system-prompt.expected.md +++ b/snapshots/session/team-targets/system-prompt.expected.md @@ -15,7 +15,7 @@ Use the target returned by spawn_teammate or list_agents for send_message and in Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/text-turn/system-prompt.expected.md b/snapshots/session/text-turn/system-prompt.expected.md index 4129b103da..cfc9e19da9 100644 --- a/snapshots/session/text-turn/system-prompt.expected.md +++ b/snapshots/session/text-turn/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/web-fetch/system-prompt.expected.md b/snapshots/session/web-fetch/system-prompt.expected.md index f8ff1ad2b1..ec6c26f5ef 100644 --- a/snapshots/session/web-fetch/system-prompt.expected.md +++ b/snapshots/session/web-fetch/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/web-search-unconfigured/system-prompt.expected.md b/snapshots/session/web-search-unconfigured/system-prompt.expected.md index a839f0d76d..7ada3f9ff7 100644 --- a/snapshots/session/web-search-unconfigured/system-prompt.expected.md +++ b/snapshots/session/web-search-unconfigured/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/workflow-confinement/system-prompt.expected.md b/snapshots/session/workflow-confinement/system-prompt.expected.md index 4129b103da..cfc9e19da9 100644 --- a/snapshots/session/workflow-confinement/system-prompt.expected.md +++ b/snapshots/session/workflow-confinement/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/workspace-dependencies/system-prompt.expected.md b/snapshots/session/workspace-dependencies/system-prompt.expected.md index fb8a26b762..99835b05a4 100644 --- a/snapshots/session/workspace-dependencies/system-prompt.expected.md +++ b/snapshots/session/workspace-dependencies/system-prompt.expected.md @@ -5,7 +5,7 @@ You are a coding assistant powered by the deepseek-v4-flash model. Your bash too Verify your work by running the code or tests. Keep answers brief and factual. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/worktree/system-prompt.expected.md b/snapshots/session/worktree/system-prompt.expected.md index 4129b103da..cfc9e19da9 100644 --- a/snapshots/session/worktree/system-prompt.expected.md +++ b/snapshots/session/worktree/system-prompt.expected.md @@ -7,7 +7,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/web/creation-recommendations/system-prompt.expected.md b/snapshots/web/creation-recommendations/system-prompt.expected.md index 5ee4be0c03..069e0c706f 100644 --- a/snapshots/web/creation-recommendations/system-prompt.expected.md +++ b/snapshots/web/creation-recommendations/system-prompt.expected.md @@ -6,7 +6,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/web/fresh-round-trip/system-prompt.expected.md b/snapshots/web/fresh-round-trip/system-prompt.expected.md index 5ee4be0c03..069e0c706f 100644 --- a/snapshots/web/fresh-round-trip/system-prompt.expected.md +++ b/snapshots/web/fresh-round-trip/system-prompt.expected.md @@ -6,7 +6,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/web/official-subagent-bundle/system-prompt.expected.md b/snapshots/web/official-subagent-bundle/system-prompt.expected.md index c8dd24b7af..5e9e80e632 100644 --- a/snapshots/web/official-subagent-bundle/system-prompt.expected.md +++ b/snapshots/web/official-subagent-bundle/system-prompt.expected.md @@ -8,7 +8,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/web/optional-string-editor/system-prompt.expected.md b/snapshots/web/optional-string-editor/system-prompt.expected.md index 8ecaade15e..0807f9f05e 100644 --- a/snapshots/web/optional-string-editor/system-prompt.expected.md +++ b/snapshots/web/optional-string-editor/system-prompt.expected.md @@ -8,7 +8,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/web/plugin-recommendations/system-prompt.expected.md b/snapshots/web/plugin-recommendations/system-prompt.expected.md index 5ee4be0c03..069e0c706f 100644 --- a/snapshots/web/plugin-recommendations/system-prompt.expected.md +++ b/snapshots/web/plugin-recommendations/system-prompt.expected.md @@ -6,7 +6,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/web/ptc-round/system-prompt.expected.md b/snapshots/web/ptc-round/system-prompt.expected.md index 68df54fc35..0d5612f486 100644 --- a/snapshots/web/ptc-round/system-prompt.expected.md +++ b/snapshots/web/ptc-round/system-prompt.expected.md @@ -8,7 +8,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. From 5b25f04e6f3b4f260b803e1cc7c164366015cade Mon Sep 17 00:00:00 2001 From: Chinesezjc Date: Mon, 26 Oct 2026 11:26:43 +0800 Subject: [PATCH 3/7] docs(notes): record the read guidance evidence The note keeps the #6057 observation and the 2026-10-23 evaluation of the single sentence so a later prompt trim does not remove it again. --- ...-10-26-read-guidance-line-ranges.i18n.yaml | 22 ++++++++++++ .../2026-10-26-read-guidance-line-ranges.md | 34 +++++++++++++++++++ ...2026-10-26-read-guidance-line-ranges.zh.md | 34 +++++++++++++++++++ 3 files changed, 90 insertions(+) create mode 100644 .agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.i18n.yaml create mode 100644 .agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.md create mode 100644 .agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.zh.md diff --git a/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.i18n.yaml b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.i18n.yaml new file mode 100644 index 0000000000..c50e4ba604 --- /dev/null +++ b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.i18n.yaml @@ -0,0 +1,22 @@ +# Bilingual-pair consistency record for 2026-10-26-read-guidance-line-ranges.md (docs/i18n/README.md): per heading +# section, a hash of its English and Chinese blocks outside code blocks and generated regions. +# After editing either side, bring the other along and re-record with: +# pnpm run verify-translation-pairing --write .agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.md +/agent-note-read-guidance-names-shell-readers-and-line-ranges: + en: 1926710614598539 + zh: b0106d4a6a2d648d +/agent-note-read-guidance-names-shell-readers-and-line-ranges/problem: + en: 0b8dc80eb5a32bfb + zh: e3a5588a330af784 +/agent-note-read-guidance-names-shell-readers-and-line-ranges/decision: + en: 34f18307f7ad87af + zh: 21c466c6ce6c598d +/agent-note-read-guidance-names-shell-readers-and-line-ranges/alternatives-considered: + en: a18ff1df8c97931c + zh: fd071b1b02755285 +/agent-note-read-guidance-names-shell-readers-and-line-ranges/verification: + en: 08557f13c54f2912 + zh: a0ae60861df1aea8 +/agent-note-read-guidance-names-shell-readers-and-line-ranges/consequences: + en: d92130932f757899 + zh: 011b8b66de41cf06 diff --git a/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.md b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.md new file mode 100644 index 0000000000..66e1a6396d --- /dev/null +++ b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.md @@ -0,0 +1,34 @@ +# Agent Note: Read guidance names shell readers and line ranges + +Status: implemented + +English | [中文](2026-10-26-read-guidance-line-ranges.zh.md) + +## Problem + +The read guidance named only `cat` as the shell command the read tool replaces, and described `offset`/`limit` as continuing a large file rather than reading a line range. #6057 recorded a long Session reading ranges with `sed -n X,Yp` 60 times. #6054 added `sed`, `head`, `tail`, and the line-range wording; a later prompt revert removed them together with unrelated changes. + +The 2026-10-23 evaluation of the SDK profile (native tools, six benchmarks) measured this sentence as the only change: Pass@1 mean −0.03pp and Pass@3 mean +0.70pp versus the base commit, with mixed step and token deltas (ProgramBench-New −15.5 steps, Terminal-Bench-v4 +13.5 steps). The PTC mode runs did not include this variant; the section renders in every request where `read` is visible. + +## Decision + +Restore the #6054 wording, byte-identical: `Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.` The read tool and its guidance are owned by `@deepseek-ai/dsh-tool-fs`; write and edit guidance are unchanged. + +## Alternatives considered + +**Rely on the read tool schema.** The schema already documents `offset` and `limit`, but #6057 shows the model chose `sed` while that schema existed; the guidance is the only model-visible place that names `sed`, `head`, and `tail`. + +**Restore every prompt phrase reverted together with this sentence.** The subagent end-turn sentence, the `run_code` argument order, the PTC syntax ownership, and the SDK persona are separate decisions; the first is already restored, and the others carry their own evidence. + +**Say "line range" without naming shell commands.** The observed failure was choosing shell commands, so the sentence names them. + +## Verification + +- `packages/fs/tool-fs/tests/tools.spec.ts` asserts the rendered guidance text. +- 89 `snapshots/**/system-prompt*.expected.md` sidecars carry the restored sentence and replay through the shipped profiles in `test:snapshot`; two pinned historical sidecars (`web/cordis-tool-round`, `web/schedule-catalog`) retain their recorded text. +- The evaluation above measured this single change on the native SDK profile. + +## Consequences + +- Every request with the read tool carries three more command names and a line-range clause, about 10 tokens. +- The model is directed to the read tool for line ranges instead of `cat`, `sed`, `head`, or `tail`. diff --git a/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.zh.md b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.zh.md new file mode 100644 index 0000000000..747827cbf0 --- /dev/null +++ b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.zh.md @@ -0,0 +1,34 @@ +# Agent Note: read 指导点名 shell 读取命令与行区间 + +Status: implemented + +[English](2026-10-26-read-guidance-line-ranges.md) | 中文 + +## 问题 + +read 指导只把 `cat` 点名为 read 工具替代的 shell 命令，并把 `offset`/`limit` 描述成继续读大文件，而不是读行区间。#6057 记录了一个长 Session 用 `sed -n X,Yp` 读行区间 60 次。#6054 增加了 `sed`、`head`、`tail` 和行区间措辞；后来的一次提示词回退把它们和不相关的改动一起删掉了。 + +2026-10-23 对 SDK profile（native 工具、六个 benchmark）的评测里，这句是唯一改动：相对 base commit，Pass@1 均值 −0.03pp、Pass@3 均值 +0.70pp，步数与 token 变化方向不一（ProgramBench-New −15.5 步、Terminal-Bench-v4 +13.5 步）。PTC 模式的运行没有包含这个变体；只要 `read` 可见，这段就会进入每个请求。 + +## 决策 + +逐字恢复 #6054 的措辞：`Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file.` read 工具及其指导归 `@deepseek-ai/dsh-tool-fs` 所有；write 与 edit 的指导不变。 + +## 考虑过的替代方案 + +**只依赖 read 工具 schema。** schema 已经写明 `offset` 与 `limit`，但 #6057 显示在那个 schema 存在时模型仍选择 `sed`；指导是唯一点名 `sed`、`head`、`tail` 的模型可见位置。 + +**把与这句一起被回退的所有提示词都恢复。** subagent 结束本轮句、`run_code` 参数顺序、PTC 语法归属、SDK persona 是各自独立的决定；第一项已经恢复，其余各有自己的证据。 + +**只说“行区间”，不点名 shell 命令。** 观测到的失败就是模型选择 shell 命令，所以这句点名它们。 + +## 验证 + +- `packages/fs/tool-fs/tests/tools.spec.ts` 断言渲染出的指导文本。 +- 89 个 `snapshots/**/system-prompt*.expected.md` sidecar 带有恢复后的句子，由 `test:snapshot` 通过随附 profile 回放；两个显式 pin 的历史 sidecar（`web/cordis-tool-round`、`web/schedule-catalog`）保留录制文本。 +- 上面的评测在 native SDK profile 上只改了这一句进行测量。 + +## 影响 + +- 只要 read 工具存在，每个请求多三个命令名和一句行区间说明，约 10 token。 +- 模型读行区间时被引导到 read 工具，而不是 `cat`、`sed`、`head`、`tail`。 From ce988594eef95a0e05edda8313bcd40d76f7d479 Mon Sep 17 00:00:00 2001 From: Chinesezjc Date: Thu, 29 Oct 2026 16:14:35 +0800 Subject: [PATCH 4/7] docs(notes): correct the read guidance evidence and cross-links Split the sidecar coverage into 83 test:snapshot sidecars and 6 web snapshots run by test:web:ci, state the Pass@3 denominator, record that the benchmark is neutral for this sentence, and link the read and subagent notes to each other in both languages. --- ...26-10-21-subagent-end-turn-guidance.i18n.yaml | 4 ++-- .../2026-10-21-subagent-end-turn-guidance.md | 2 +- .../2026-10-21-subagent-end-turn-guidance.zh.md | 2 +- ...026-10-26-read-guidance-line-ranges.i18n.yaml | 16 ++++++++-------- .../2026-10-26-read-guidance-line-ranges.md | 7 ++++--- .../2026-10-26-read-guidance-line-ranges.zh.md | 7 ++++--- 6 files changed, 20 insertions(+), 18 deletions(-) diff --git a/.agents/notes/implemented/bug-fix/2026-10-21-subagent-end-turn-guidance.i18n.yaml b/.agents/notes/implemented/bug-fix/2026-10-21-subagent-end-turn-guidance.i18n.yaml index 8b8bba1309..bbc63b3c3b 100644 --- a/.agents/notes/implemented/bug-fix/2026-10-21-subagent-end-turn-guidance.i18n.yaml +++ b/.agents/notes/implemented/bug-fix/2026-10-21-subagent-end-turn-guidance.i18n.yaml @@ -12,8 +12,8 @@ en: 47b44ed9313c2ccf zh: 7ad254f8ef88351d /agent-note-subagent-end-turn-guidance-stays-in-the-delegation-paragraph/alternatives-considered: - en: d52fa1af379dea5b - zh: 4e404994f7a607dc + en: 3153c1e7563a3357 + zh: 9841db2b0156075b /agent-note-subagent-end-turn-guidance-stays-in-the-delegation-paragraph/verification: en: be076216381ea64d zh: 2da8d9819c20e2fe diff --git a/.agents/notes/implemented/bug-fix/2026-10-21-subagent-end-turn-guidance.md b/.agents/notes/implemented/bug-fix/2026-10-21-subagent-end-turn-guidance.md index cd800e94fe..8a25a23102 100644 --- a/.agents/notes/implemented/bug-fix/2026-10-21-subagent-end-turn-guidance.md +++ b/.agents/notes/implemented/bug-fix/2026-10-21-subagent-end-turn-guidance.md @@ -29,7 +29,7 @@ The sentence stays one literal line. Rewording `the next result starts a new tur **Move the guidance into the tool description.** The paragraph is assembled from the set of visible delegation tools and lists their names; the tool description describes one tool. Moving the sentence changes ownership without changing the behavior it prevents. -**Restore every prompt phrase reverted together with this sentence.** The read guidance and the `run_code` argument order are separate decisions with their own evidence; this note records only the delegation paragraph. +**Restore every prompt phrase reverted together with this sentence.** The read guidance ([2026-10-26 note](2026-10-26-read-guidance-line-ranges.md)) and the `run_code` argument order are separate decisions with their own evidence; this note records only the delegation paragraph. ## Verification diff --git a/.agents/notes/implemented/bug-fix/2026-10-21-subagent-end-turn-guidance.zh.md b/.agents/notes/implemented/bug-fix/2026-10-21-subagent-end-turn-guidance.zh.md index b11656473a..ba1c5cbc6a 100644 --- a/.agents/notes/implemented/bug-fix/2026-10-21-subagent-end-turn-guidance.zh.md +++ b/.agents/notes/implemented/bug-fix/2026-10-21-subagent-end-turn-guidance.zh.md @@ -29,7 +29,7 @@ Status: implemented **把说明移进工具描述。** 这段指导按可见委派工具集合组装并列出工具名，工具描述只描述单个工具。移动这句会改变归属，但不改变它阻止的行为。 -**把与这句一起被回退的所有提示词都恢复。** read 指导与 `run_code` 参数顺序是各自有证据的独立决定；本记录只覆盖委派段。 +**把与这句一起被回退的所有提示词都恢复。** read 指导（[2026-10-26 note](2026-10-26-read-guidance-line-ranges.zh.md)）与 `run_code` 参数顺序是各自有证据的独立决定；本记录只覆盖委派段。 ## 验证 diff --git a/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.i18n.yaml b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.i18n.yaml index c50e4ba604..c682d07e6b 100644 --- a/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.i18n.yaml +++ b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.i18n.yaml @@ -6,17 +6,17 @@ en: 1926710614598539 zh: b0106d4a6a2d648d /agent-note-read-guidance-names-shell-readers-and-line-ranges/problem: - en: 0b8dc80eb5a32bfb - zh: e3a5588a330af784 + en: 4189d516419d8d12 + zh: 30d8496064dd44e3 /agent-note-read-guidance-names-shell-readers-and-line-ranges/decision: en: 34f18307f7ad87af zh: 21c466c6ce6c598d /agent-note-read-guidance-names-shell-readers-and-line-ranges/alternatives-considered: - en: a18ff1df8c97931c - zh: fd071b1b02755285 + en: aea7ffb1159ab81a + zh: 4842ca79dc30654d /agent-note-read-guidance-names-shell-readers-and-line-ranges/verification: - en: 08557f13c54f2912 - zh: a0ae60861df1aea8 + en: 7d7a46a6e98087da + zh: 80339994cbd09b1f /agent-note-read-guidance-names-shell-readers-and-line-ranges/consequences: - en: d92130932f757899 - zh: 011b8b66de41cf06 + en: cf55161ea197a7a9 + zh: fa10ca413f8fd726 diff --git a/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.md b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.md index 66e1a6396d..447aaca9aa 100644 --- a/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.md +++ b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.md @@ -8,7 +8,7 @@ English | [中文](2026-10-26-read-guidance-line-ranges.zh.md) The read guidance named only `cat` as the shell command the read tool replaces, and described `offset`/`limit` as continuing a large file rather than reading a line range. #6057 recorded a long Session reading ranges with `sed -n X,Yp` 60 times. #6054 added `sed`, `head`, `tail`, and the line-range wording; a later prompt revert removed them together with unrelated changes. -The 2026-10-23 evaluation of the SDK profile (native tools, six benchmarks) measured this sentence as the only change: Pass@1 mean −0.03pp and Pass@3 mean +0.70pp versus the base commit, with mixed step and token deltas (ProgramBench-New −15.5 steps, Terminal-Bench-v4 +13.5 steps). The PTC mode runs did not include this variant; the section renders in every request where `read` is visible. +The 2026-10-23 evaluation of the SDK profile (native tools, six benchmarks) measured this sentence as the only change: Pass@1 mean −0.03pp and Pass@3 mean +0.70pp over the five benchmarks that report Pass@3 (ProgramBench-New has none) versus the base commit, with mixed step and token deltas (ProgramBench-New −15.5 steps, Terminal-Bench-v4 +13.5 steps). The PTC mode runs did not include this variant; the section renders in every request where `read` is visible. ## Decision @@ -18,17 +18,18 @@ Restore the #6054 wording, byte-identical: `Use the read tool — not shell comm **Rely on the read tool schema.** The schema already documents `offset` and `limit`, but #6057 shows the model chose `sed` while that schema existed; the guidance is the only model-visible place that names `sed`, `head`, and `tail`. -**Restore every prompt phrase reverted together with this sentence.** The subagent end-turn sentence, the `run_code` argument order, the PTC syntax ownership, and the SDK persona are separate decisions; the first is already restored, and the others carry their own evidence. +**Restore every prompt phrase reverted together with this sentence.** The subagent end-turn sentence, the `run_code` argument order, the PTC syntax ownership, and the SDK persona are separate decisions; the first is already restored ([subagent end-turn note](2026-10-21-subagent-end-turn-guidance.md)), and the others carry their own evidence. **Say "line range" without naming shell commands.** The observed failure was choosing shell commands, so the sentence names them. ## Verification - `packages/fs/tool-fs/tests/tools.spec.ts` asserts the rendered guidance text. -- 89 `snapshots/**/system-prompt*.expected.md` sidecars carry the restored sentence and replay through the shipped profiles in `test:snapshot`; two pinned historical sidecars (`web/cordis-tool-round`, `web/schedule-catalog`) retain their recorded text. +- 83 `snapshots/**/system-prompt*.expected.md` sidecars and 6 `snapshots/web/*` sidecars carry the restored sentence; `test:snapshot` replays the 83 session and SDK sidecars, and `pnpm run test:web:ci` replays the 6 web sidecars (the `node 24 / snapshots and artifacts` lane runs both). Two pinned historical sidecars (`web/cordis-tool-round`, `web/schedule-catalog`) retain their recorded text. - The evaluation above measured this single change on the native SDK profile. ## Consequences - Every request with the read tool carries three more command names and a line-range clause, about 10 tokens. - The model is directed to the read tool for line ranges instead of `cat`, `sed`, `head`, or `tail`. +- The benchmark measured this sentence as neutral; keeping it rests on the #6057 production observation, not on a measured quality gain. diff --git a/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.zh.md b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.zh.md index 747827cbf0..c1168bb1b7 100644 --- a/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.zh.md +++ b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.zh.md @@ -8,7 +8,7 @@ Status: implemented read 指导只把 `cat` 点名为 read 工具替代的 shell 命令，并把 `offset`/`limit` 描述成继续读大文件，而不是读行区间。#6057 记录了一个长 Session 用 `sed -n X,Yp` 读行区间 60 次。#6054 增加了 `sed`、`head`、`tail` 和行区间措辞；后来的一次提示词回退把它们和不相关的改动一起删掉了。 -2026-10-23 对 SDK profile（native 工具、六个 benchmark）的评测里，这句是唯一改动：相对 base commit，Pass@1 均值 −0.03pp、Pass@3 均值 +0.70pp，步数与 token 变化方向不一（ProgramBench-New −15.5 步、Terminal-Bench-v4 +13.5 步）。PTC 模式的运行没有包含这个变体；只要 `read` 可见，这段就会进入每个请求。 +2026-10-23 对 SDK profile（native 工具、六个 benchmark）的评测里，这句是唯一改动：相对 base commit，Pass@1 均值 −0.03pp、Pass@3 均值 +0.70pp（该均值取报告 Pass@3 的五个 benchmark；ProgramBench-New 没有 Pass@3），步数与 token 变化方向不一（ProgramBench-New −15.5 步、Terminal-Bench-v4 +13.5 步）。PTC 模式的运行没有包含这个变体；只要 `read` 可见，这段就会进入每个请求。 ## 决策 @@ -18,17 +18,18 @@ read 指导只把 `cat` 点名为 read 工具替代的 shell 命令，并把 `of **只依赖 read 工具 schema。** schema 已经写明 `offset` 与 `limit`，但 #6057 显示在那个 schema 存在时模型仍选择 `sed`；指导是唯一点名 `sed`、`head`、`tail` 的模型可见位置。 -**把与这句一起被回退的所有提示词都恢复。** subagent 结束本轮句、`run_code` 参数顺序、PTC 语法归属、SDK persona 是各自独立的决定；第一项已经恢复，其余各有自己的证据。 +**把与这句一起被回退的所有提示词都恢复。** subagent 结束本轮句、`run_code` 参数顺序、PTC 语法归属、SDK persona 是各自独立的决定；第一项已经恢复（[subagent 结束本轮 note](2026-10-21-subagent-end-turn-guidance.zh.md)），其余各有自己的证据。 **只说“行区间”，不点名 shell 命令。** 观测到的失败就是模型选择 shell 命令，所以这句点名它们。 ## 验证 - `packages/fs/tool-fs/tests/tools.spec.ts` 断言渲染出的指导文本。 -- 89 个 `snapshots/**/system-prompt*.expected.md` sidecar 带有恢复后的句子，由 `test:snapshot` 通过随附 profile 回放；两个显式 pin 的历史 sidecar（`web/cordis-tool-round`、`web/schedule-catalog`）保留录制文本。 +- 83 个 `snapshots/**/system-prompt*.expected.md` sidecar 和 6 个 `snapshots/web/*` sidecar 带有恢复后的句子；`test:snapshot` 回放 83 个 session/SDK sidecar，`pnpm run test:web:ci` 回放 6 个 web sidecar（`node 24 / snapshots and artifacts` lane 两条都跑）。两个显式 pin 的历史 sidecar（`web/cordis-tool-round`、`web/schedule-catalog`）保留录制文本。 - 上面的评测在 native SDK profile 上只改了这一句进行测量。 ## 影响 - 只要 read 工具存在，每个请求多三个命令名和一句行区间说明，约 10 token。 - 模型读行区间时被引导到 read 工具，而不是 `cat`、`sed`、`head`、`tail`。 +- benchmark 上这句测得为中性；保留它依据的是 #6057 的生产观测，而不是测到的质量收益。 From 09bc71f831627d968c6b9577bd95be17741dd92a Mon Sep 17 00:00:00 2001 From: Chinesezjc Date: Thu, 29 Oct 2026 16:50:16 +0800 Subject: [PATCH 5/7] test(snapshot): carry the read guidance into scenarios merged from master The merge from master adds four scenarios recorded before the restore (ptc-script-fresh, ptc-script-retained, command-attachments, plan-review); their system-prompt sidecars still show the old sentence. --- .../sdk/command-attachments/system-prompt.expected.md | 2 +- snapshots/sdk/plan-review/system-prompt.expected.md | 10 +++++----- .../session/ptc-script-fresh/system-prompt.expected.md | 2 +- .../ptc-script-retained/system-prompt.expected.md | 2 +- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/snapshots/sdk/command-attachments/system-prompt.expected.md b/snapshots/sdk/command-attachments/system-prompt.expected.md index 87c8754913..7b66cec998 100644 --- a/snapshots/sdk/command-attachments/system-prompt.expected.md +++ b/snapshots/sdk/command-attachments/system-prompt.expected.md @@ -19,7 +19,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/sdk/plan-review/system-prompt.expected.md b/snapshots/sdk/plan-review/system-prompt.expected.md index d76bb0ad7b..4590ecdd88 100644 --- a/snapshots/sdk/plan-review/system-prompt.expected.md +++ b/snapshots/sdk/plan-review/system-prompt.expected.md @@ -6,7 +6,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -53,7 +53,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -87,7 +87,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -134,7 +134,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. @@ -168,7 +168,7 @@ Tokens prefixed with @ are paths the user explicitly referenced. Relative paths Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/ptc-script-fresh/system-prompt.expected.md b/snapshots/session/ptc-script-fresh/system-prompt.expected.md index cee1d38ca1..f78d20535d 100644 --- a/snapshots/session/ptc-script-fresh/system-prompt.expected.md +++ b/snapshots/session/ptc-script-fresh/system-prompt.expected.md @@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. diff --git a/snapshots/session/ptc-script-retained/system-prompt.expected.md b/snapshots/session/ptc-script-retained/system-prompt.expected.md index 8b1fb247db..3dc763d9ea 100644 --- a/snapshots/session/ptc-script-retained/system-prompt.expected.md +++ b/snapshots/session/ptc-script-retained/system-prompt.expected.md @@ -9,7 +9,7 @@ Verify your work by running the code or tests. Keep answers brief and factual. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write (the default fs-observation-policy requires it) and prefer edit for targeted changes. From 58c375d8a5676753ae024aeb9891f73a2c5609d9 Mon Sep 17 00:00:00 2001 From: Chinesezjc Date: Thu, 29 Oct 2026 16:51:48 +0800 Subject: [PATCH 6/7] docs(notes): avoid fixed sidecar counts in the read note --- .../bug-fix/2026-10-26-read-guidance-line-ranges.i18n.yaml | 4 ++-- .../bug-fix/2026-10-26-read-guidance-line-ranges.md | 2 +- .../bug-fix/2026-10-26-read-guidance-line-ranges.zh.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.i18n.yaml b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.i18n.yaml index c682d07e6b..86e21bee13 100644 --- a/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.i18n.yaml +++ b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.i18n.yaml @@ -15,8 +15,8 @@ en: aea7ffb1159ab81a zh: 4842ca79dc30654d /agent-note-read-guidance-names-shell-readers-and-line-ranges/verification: - en: 7d7a46a6e98087da - zh: 80339994cbd09b1f + en: cbc16bfba4abe862 + zh: 9a71e6c020c01f69 /agent-note-read-guidance-names-shell-readers-and-line-ranges/consequences: en: cf55161ea197a7a9 zh: fa10ca413f8fd726 diff --git a/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.md b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.md index 447aaca9aa..60ad77abee 100644 --- a/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.md +++ b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.md @@ -25,7 +25,7 @@ Restore the #6054 wording, byte-identical: `Use the read tool — not shell comm ## Verification - `packages/fs/tool-fs/tests/tools.spec.ts` asserts the rendered guidance text. -- 83 `snapshots/**/system-prompt*.expected.md` sidecars and 6 `snapshots/web/*` sidecars carry the restored sentence; `test:snapshot` replays the 83 session and SDK sidecars, and `pnpm run test:web:ci` replays the 6 web sidecars (the `node 24 / snapshots and artifacts` lane runs both). Two pinned historical sidecars (`web/cordis-tool-round`, `web/schedule-catalog`) retain their recorded text. +- Every recorded `system-prompt*.expected.md` sidecar that renders the read guidance carries the restored sentence: `test:snapshot` replays the session and SDK set, and `pnpm run test:web:ci` replays the `snapshots/web` set (the `node 24 / snapshots and artifacts` lane runs both). Two pinned historical sidecars (`web/cordis-tool-round`, `web/schedule-catalog`) retain their recorded text. - The evaluation above measured this single change on the native SDK profile. ## Consequences diff --git a/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.zh.md b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.zh.md index c1168bb1b7..25487ea733 100644 --- a/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.zh.md +++ b/.agents/notes/implemented/bug-fix/2026-10-26-read-guidance-line-ranges.zh.md @@ -25,7 +25,7 @@ read 指导只把 `cat` 点名为 read 工具替代的 shell 命令，并把 `of ## 验证 - `packages/fs/tool-fs/tests/tools.spec.ts` 断言渲染出的指导文本。 -- 83 个 `snapshots/**/system-prompt*.expected.md` sidecar 和 6 个 `snapshots/web/*` sidecar 带有恢复后的句子；`test:snapshot` 回放 83 个 session/SDK sidecar，`pnpm run test:web:ci` 回放 6 个 web sidecar（`node 24 / snapshots and artifacts` lane 两条都跑）。两个显式 pin 的历史 sidecar（`web/cordis-tool-round`、`web/schedule-catalog`）保留录制文本。 +- 所有渲染 read 指导的 `system-prompt*.expected.md` sidecar 都带有恢复后的句子：`test:snapshot` 回放 session 与 SDK 集合，`pnpm run test:web:ci` 回放 `snapshots/web` 集合（`node 24 / snapshots and artifacts` lane 两条都跑）。两个显式 pin 的历史 sidecar（`web/cordis-tool-round`、`web/schedule-catalog`）保留录制文本。 - 上面的评测在 native SDK profile 上只改了这一句进行测量。 ## 影响 From ec587a015dd0b8258a2aa9f3a93e5368bbbc284d Mon Sep 17 00:00:00 2001 From: Chinesezjc Date: Mon, 2 Nov 2026 16:42:47 +0800 Subject: [PATCH 7/7] test(snapshot): carry the read guidance into the apply-patch scenarios The apply-patch scenarios were recorded before this restore; their shared system prompt sidecar still shows the old read sentence. --- snapshots/session/apply-patch-update/system-prompt.expected.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/snapshots/session/apply-patch-update/system-prompt.expected.md b/snapshots/session/apply-patch-update/system-prompt.expected.md index b5b2718f24..042068111e 100644 --- a/snapshots/session/apply-patch-update/system-prompt.expected.md +++ b/snapshots/session/apply-patch-update/system-prompt.expected.md @@ -4,7 +4,7 @@ You are a concise snapshot agent. Check the [exit code: N] marker on every bash result; investigate failures before moving on. -Use the read tool — not shell commands like cat — to inspect text files. Use offset and limit to continue reading large files. +Use the read tool — not shell commands like cat, sed, head, or tail — to inspect text files. Use offset and limit to read a line range or continue a large file. Read an existing file before overwriting it with write and prefer edit for targeted changes.