diff --git a/pipeline_service/capability_tools.py b/pipeline_service/capability_tools.py
index 9d03850..fffdffe 100644
--- a/pipeline_service/capability_tools.py
+++ b/pipeline_service/capability_tools.py
@@ -141,13 +141,13 @@ TOOL_SCHEMAS = {
     },
     "start_fix": {
         "module": "bug_capability",
-        "description": "开始修复 Bug：confirmed → fixing（记录处理人）",
+        "description": "开始修复 Bug：open/confirmed → fixing（记录处理人）。回退重做/修复 Bug 任务里修完代码必须调用，open 状态也可直接修复（PM review_rollback 回退时不走 confirm_bug）",
         "params": {"bug_id": "Bug ID", "assignee_id": "处理人(可选)"},
         "required": ["bug_id"],
     },
     "fix_bug": {
         "module": "bug_capability",
-        "description": "修复完成 Bug：fixing → fixed（附修复说明+提交）",
+        "description": "修复完成 Bug：fixing → fixed（附修复说明+提交）。修完代码必须调用，把对应 bug 标记 fixed，否则 PM 查不到 fixed bug 无法派重新部署、任务链断",
         "params": {"bug_id": "Bug ID", "fix_description": "修复说明", "fix_commit": "修复提交(可选)"},
         "required": ["bug_id"],
     },