Install or uninstall a pre-commit hook that blocks commits without a structured audit record, ensuring every code change leaves a problem/reason/approach log.
安装/卸载 pre-commit hook
| Name | Required | Description | Default |
|---|---|---|---|
| root | Yes | . | |
| uninstall | No | True 则卸载 |
Changes observed during successful MCP inspections.
v0.7.14Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
注释提供了 idempotentHint=true 和 destructiveHint=false，说明该操作是幂等的且非破坏性，但描述未提供额外行为信息。例如，是否会影响现有配置、是否需要在特定目录下运行等。注释已经涵盖了幂等性和安全性，描述未增加太多，但也没有矛盾。由于描述未补充任何行为细节，评分为 3。
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?
描述非常简洁，仅一句话，没有冗余。但信息量较低，未包含任何使用场景或上下文。简洁但可能过度简化，不过仍然清晰地传达了核心功能。
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?
工具没有输出模式，注释提供了幂等性和非破坏性，但描述未提供安装/卸载的具体影响、是否需要 root 权限、是否修改配置文件等。对于这样一个可能影响项目配置的工具，描述不够完整，无法让代理完全理解其副作用。考虑到复杂度较低（2 个参数），但缺少关键上下文。
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?
输入模式描述了两个参数：root（默认 '.'）和 uninstall（默认 false，描述为'True 则卸载'）。描述本身没有为参数提供额外语义，但模式中已经包含了必要的描述。覆盖率为 50%，即 uninstall 参数有描述，root 参数仅有默认值但无描述。描述也未在正文中解释参数含义，因此未超出模式本身。基线为 3。
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?
描述清晰说明了工具的功能：安装/卸载 pre-commit hook。动词明确（安装/卸载），资源明确（pre-commit hook）。但未与兄弟工具区分，例如 pandaone_install_git 可能涉及类似的安装操作，但此处描述未明确说明与安装 git 或其它安装类工具的区别。
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?
描述未提供使用时机指导，例如何时安装 vs 卸载，或者与兄弟工具（如 pandaone_init）的关联。虽然参数 uninstall 暗示了两种用法，但描述未明确说明何时应使用此工具而非其他工具，也未提及任何前提条件或上下文。
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.