teamai-cli 0.17.1 → 0.17.2

package/agents/teamai-recall.md

@@ -1,6 +1,6 @@
 ---
 name: teamai-recall
-description: Search the team knowledge base (skills + learnings + docs + rules + codebase graph) and return a compact, structured summary with doc_ids — instead of dumping full knowledge content into the main conversation. Invoke this BEFORE any task involving code changes, troubleshooting, or design.
+description: Search the team knowledge base (skills + learnings + docs + rules + codebase graph) and return a compact, structured summary with doc_ids — instead of dumping full knowledge content into the main conversation. Invoke when the task may benefit from team knowledge context — skip when the user already provided context, answers are in local files, or the change is trivial.
 tools: Bash, Read, Grep, Glob
 ---
 

package/dist/index.js

@@ -1772,10 +1772,17 @@ var init_builtin_rules = __esm({
     ]);
     TEAMAI_RECALL_RULE_CONTENT = `# Team Knowledge Recall (teamai)
 
-## \u89C4\u5219\uFF1A\u4EFB\u52A1\u5F00\u59CB\u524D\u5FC5\u987B\u68C0\u7D22\u56E2\u961F\u77E5\u8BC6\u5E93
+## \u89C4\u5219\uFF1A\u4EFB\u52A1\u5F00\u59CB\u524D\u68C0\u7D22\u56E2\u961F\u77E5\u8BC6\u5E93\uFF08\u63A8\u8350\uFF09
 
-**Before** starting any task that involves code changes, debugging,
-or design decisions, you **MUST** first search the team knowledge base.
+**Before** starting a task that involves code changes, debugging,
+or design decisions, you **SHOULD** search the team knowledge base
+\u2014 unless one of the skip conditions below applies.
+
+### \u8DF3\u8FC7\u6761\u4EF6\uFF08\u6EE1\u8DB3\u4EFB\u4E00\u5373\u53EF\u8DF3\u8FC7\u68C0\u7D22\uFF09
+
+1. **\u7528\u6237\u5DF2\u63D0\u4F9B\u4E0A\u4E0B\u6587** \u2014 \u7528\u6237\u5728\u6D88\u606F\u4E2D\u660E\u786E\u5F15\u7528\u4E86\u6587\u4EF6\u3001\u7ED9\u51FA\u4E86\u89E3\u51B3\u65B9\u6848\u3001\u6216\u8BF4\u660E"\u7B54\u6848\u5728\u5F53\u524D\u76EE\u5F55/\u8FD9\u4E2A\u6587\u4EF6\u91CC"
+2. **\u672C\u5730\u6587\u4EF6\u5DF2\u6709\u7B54\u6848** \u2014 \u4EFB\u52A1\u4FE1\u606F\u53EF\u76F4\u63A5\u4ECE\u5F53\u524D\u5DE5\u4F5C\u533A\u6587\u4EF6\u83B7\u5F97\uFF08\u5982\u4FEE\u590D\u5F53\u524D\u6587\u4EF6\u4E2D\u660E\u663E\u7684 bug\uFF09
+3. **\u7B80\u5355/\u5C40\u90E8\u6539\u52A8** \u2014 \u5BF9\u5DF2\u77E5\u6587\u4EF6\u505A\u5C0F\u8303\u56F4\u4FEE\u6539\uFF08\u4FEE typo\u3001\u8C03\u6574\u53C2\u6570\u503C\u3001\u6539\u683C\u5F0F\uFF09\uFF0C\u65E0\u9700\u989D\u5916\u77E5\u8BC6\u80CC\u666F
 
 ### \u65B9\u5F0F\u4E00\uFF1A\u901A\u8FC7 Subagent\uFF08\u63A8\u8350\uFF0C\u9002\u7528\u4E8E\u652F\u6301 Agent tool \u7684\u5DE5\u5177\uFF09
 
@@ -10146,15 +10153,24 @@ function compileRecallRulesBlock() {
     "",
     "## Team Knowledge Recall (teamai)",
     "",
-    "**Before** starting any task that involves code changes, debugging,",
-    "or design decisions, you **MUST** first invoke the `teamai-recall`",
+    "**Before** starting a task that involves code changes, debugging,",
+    "or design decisions, you **SHOULD** invoke the `teamai-recall`",
     "subagent via the Agent tool with a concise natural-language",
-    "description of the task. The subagent will return a compact summary",
-    "of relevant team knowledge (skills, learnings, docs, rules) without",
-    "polluting this conversation with raw content.",
+    "description of the task \u2014 unless one of these skip conditions applies:",
+    "",
+    "1. **User already provided context** \u2014 the user referenced specific files,",
+    '   gave a solution, or said "the answer is in this directory/file".',
+    "2. **Local files have the answer** \u2014 the task info is directly available",
+    "   from the current workspace (e.g. fixing an obvious bug in the current file).",
+    "3. **Trivial/local change** \u2014 small modifications to known files (typo fix,",
+    "   parameter tweak, formatting) that need no additional knowledge.",
+    "",
+    "The subagent will return a compact summary of relevant team knowledge",
+    "(skills, learnings, docs, rules) without polluting this conversation",
+    "with raw content.",
     "",
-    "**Important constraints on agent sequencing:**",
-    "1. Always invoke `teamai-recall` subagent **first and alone** \u2014 never",
+    "**Important constraints on agent sequencing (when recall is invoked):**",
+    "1. Invoke `teamai-recall` subagent **first and alone** \u2014 never",
     "   launch it in parallel with Explore or other research agents.",
     "2. After recall returns results, use Read to get full content of the",
     "   returned files if you need more detail. Do NOT launch Explore agents",
@@ -15073,12 +15089,13 @@ function buildHintMessage() {
   return [
     "[teamai:todowrite-hint] \u4EFB\u52A1\u5DF2\u89C4\u5212\u3002",
     "",
-    "\u8BF7\u786E\u8BA4\u672C\u6B21\u4EFB\u52A1\u5F00\u59CB\u524D\u5DF2\u901A\u8FC7 Agent tool \u8C03\u7528 teamai-recall subagent \u5B8C\u6210\u77E5\u8BC6\u5E93\u68C0\u7D22\uFF1B",
-    "\u5982\u672A\u68C0\u7D22\uFF0C\u8BF7\u7ACB\u5373\u8C03\u7528 teamai-recall\uFF08\u4E00\u6B21\u5373\u53EF\uFF09\uFF0C\u5B8C\u6210\u540E\u518D\u7EE7\u7EED\u540E\u7EED Todo\u3002",
+    "\u5982\u672C\u6B21\u4EFB\u52A1\u53EF\u80FD\u53D7\u76CA\u4E8E\u56E2\u961F\u77E5\u8BC6\u5E93\uFF08\u975E\u7B80\u5355\u5C40\u90E8\u6539\u52A8\u3001\u7528\u6237\u672A\u63D0\u4F9B\u76F8\u5173\u4E0A\u4E0B\u6587\uFF09\uFF0C",
+    "\u5EFA\u8BAE\u901A\u8FC7 Agent tool \u8C03\u7528 teamai-recall subagent \u68C0\u7D22\u4E00\u6B21\u3002",
+    "\u82E5\u7528\u6237\u5DF2\u7ED9\u51FA\u5145\u5206\u4E0A\u4E0B\u6587\u6216\u4EC5\u4E3A\u7B80\u5355\u4FEE\u6539\uFF0C\u53EF\u8DF3\u8FC7\u3002",
     "",
-    "Task plan detected \u2014 confirm you have already invoked the `teamai-recall`",
-    "subagent for relevant team knowledge before executing the todo list.",
-    "If not, invoke it once now."
+    "Task plan detected \u2014 if this task may benefit from team knowledge",
+    "(not a trivial local change, user has not provided relevant context),",
+    "consider invoking the `teamai-recall` subagent once before proceeding."
   ].join("\n");
 }
 async function todoWriteHint() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teamai-cli",
-  "version": "0.17.1",
+  "version": "0.17.2",
   "description": "TeamAI — the team harness for AI agents (skill sync + shared knowledge base, powered by Git)",
   "type": "module",
   "bin": {