Initialize Story Project

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Không có annotations, mô tả phải tự đảm bảo minh bạch hành vi. Nó chỉ nói 'tạo cấu trúc thư mục và metadata' nhưng không đề cập đến việc có ghi đè dữ liệu cũ không, yêu cầu quyền, tính an toàn khi thư mục đã tồn tại, hay hậu quả của việc chạy nhiều lần.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

Một câu duy nhất, ngắn gọn, front-loaded với hành động chính và liệt kê các cấu trúc cụ thể. Không có từ thừa hay lặp lại thông tin đã có trong schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool có 7 tham số, không có output schema, và mô tả chỉ nói về hành động tạo lập. Nó thiếu thông tin về kết quả trả về (ví dụ: project info) hoặc các bước tiếp theo, nhưng với một tool khởi tạo đơn giản thì mức độ này tạm đủ.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema mô tả 100% tham số với đầy đủ description, nên baseline là 3. Mô tả tool không thêm thông tin cụ thể về cú pháp hoặc quan hệ giữa các tham số, chỉ khái quát 'metadata ban đầu'.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

Mô tả rõ ràng với động từ cụ thể 'Khởi tạo' và tài nguyên 'dự án tiểu thuyết mới', kèm chi tiết cấu trúc thư mục chuẩn (.story/, bible/, manuscript/, outline/) và metadata ban đầu. Điều này phân biệt rõ với các sibling như story_set_project hay story_scan_messy_project vì nó tạo mới từ đầu.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

Từ 'mới' ngầm cho biết dùng khi bắt đầu dự án, nhưng không nêu rõ khi nào không nên dùng, hoặc so sánh với các tool thay thế như story_scan_messy_project cho dự án đã tồn tại. Không có hướng dẫn loại trừ rõ ràng.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.