opensource/inkos
3
0
Fork 0
mirror of https://github.com/Narcooo/inkos.git synced 2026-08-30 17:22:02 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs(core): clarify edit/write tool boundaries vs specialised tools

Browse Source 
The generic edit and write tools were described abstractly. Spell out
when to reach for specialised tools instead — patch_chapter_text for
chapter text, write_truth_file for canonical truth files,
revise_chapter for chapter revisions — so the agent stops overwriting
chapters or truth files with the generic tools.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
fanghanjun
2026-04-16 10:05:15 -07:00
parent 31d170a9e0
commit 291f038e59
2 changed files with 10 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
packages/core/src/agent/agent-system-prompt.ts
+4 -4
View File
@@ -82,8 +82,8 @@ export function buildAgentSystemPrompt(bookId: string | null, language: string):
- **write_truth_file** — 整文件覆盖真相文件（story_bible、volume_outline、book_rules、current_focus 等）
- **rename_entity** — 统一改角色/实体名
- **patch_chapter_text** — 对已有章节做局部定点修补
- **edit** — 通用精确字符串替换编辑
- **write** — 新建或整文件覆盖写入
- **edit** — 在设定文件里做精确字符串替换（章节正文请用 patch_chapter_text）
- **write** — 新建文件，或者重写整个文件（已有内容会被覆盖；真相文件优先用 write_truth_file，章节修订用 revise_chapter）
- **grep** — 搜索内容（如"哪一章提到了某个角色"）
- **ls** — 列出文件或章节
@@ -131,8 +131,8 @@ export function buildAgentSystemPrompt(bookId: string | null, language: string):
- **write_truth_file** — Replace a canonical truth file in story/
- **rename_entity** — Rename a character or entity across the book
- **patch_chapter_text** — Apply a local deterministic patch to a chapter
- **edit** — Generic exact string replacement editor
- **write** — Create or fully overwrite a file
- **edit** — Exact string replacement on setting files (use patch_chapter_text for chapter text)
- **write** — Create a new file, or fully replace an existing file's content (prefer write_truth_file for canonical truth files, revise_chapter for chapter revisions)
- **grep** — Search content across chapters
- **ls** — List files or chapters
packages/core/src/agent/agent-tools.ts
+6 -4
View File
@@ -393,8 +393,9 @@ export function createEditTool(projectRoot: string): AgentTool<typeof EditParams
return {
name: "edit",
description:
"Edit a file using exact string replacement. " +
"old_string must appear exactly once in the file. Path is relative to books/.",
"Edit a file under books/ via exact string replacement. " +
"old_string must appear exactly once in the file. " +
"For chapter text use patch_chapter_text; for canonical truth files (story_bible/volume_outline/book_rules/current_focus) prefer write_truth_file.",
label: "Edit File",
parameters: EditParams,
async execute(
@@ -436,8 +437,9 @@ export function createWriteFileTool(projectRoot: string): AgentTool<typeof Write
return {
name: "write",
description:
"Create a new file or overwrite an existing file. " +
"Path is relative to books/. Parent directories are created automatically.",
"Create a new file, or fully replace an existing file's content under books/. " +
"Parent directories are created automatically. Existing content is overwritten silently — " +
"for canonical truth files prefer write_truth_file; for chapter revisions use revise_chapter.",
label: "Write File",
parameters: WriteFileParams,
async execute(