@itradingai/aiwiki 0.2.24 → 0.2.25

package/dist/src/app.js

@@ -316,7 +316,7 @@ function printContextHelp(stream) {
     writeLine(stream, "  --status active|to-review|ready|draft");
     writeLine(stream, "  --limit <1-50>");
     writeLine(stream, "");
-    writeLine(stream, "context JSON includes query_scope, result_quality, recommended_next_action, match_reasons, quality_signals, and related_refs.");
+    writeLine(stream, "context JSON includes query_scope, result_quality, recommended_next_action, match_reasons, quality_signals, related_refs, and reuse_guidance.");
 }
 function parseLintSeverity(value) {
     if (value === undefined) {
@@ -850,6 +850,7 @@ function contextOptions(args) {
 function renderQuery(context) {
     const lines = [`AIWiki 查询: ${context.query}`, ""];
     lines.push(`结果质量: matches=${context.result_quality.total_matches}, best_score=${context.result_quality.best_score}, has_wiki_entry=${context.result_quality.has_wiki_entry ? "yes" : "no"}`, `下一步建议: ${context.recommended_next_action}`, `查询范围: groups=${context.query_scope.searched_groups.join(",") || "none"}, limit=${context.query_scope.limit}, filters=${JSON.stringify(context.query_scope.filters)}`, "");
+    lines.push("Reuse workflows:", `- writing: ${context.reuse_guidance.writing}`, `- research: ${context.reuse_guidance.research}`, `- decision: ${context.reuse_guidance.decision}`, `- review: ${context.reuse_guidance.review}`, "");
     appendQueryGroup(lines, "Wiki 条目", context.matches.wiki_entries);
     appendQueryGroup(lines, "资料卡", context.matches.source_cards);
     appendQueryGroup(lines, "选题", context.matches.topics);

package/dist/src/context.js

@@ -42,6 +42,7 @@ export async function buildContext(rootPath, query, options = {}, now = new Date
             raw_refs: []
         },
         suggested_answer_structure: ["topic overview", "core claims", "available evidence", "reuse judgment", "next action"],
+        reuse_guidance: reuseGuidance(),
         warnings: []
     };
     if (!tokens.length) {
@@ -265,6 +266,14 @@ function qualitySignals(item) {
         signals.push("relationships:present");
     return signals;
 }
+function reuseGuidance() {
+    return {
+        writing: "Use matched Wiki Entries for angles, outlines, and source-backed points; check quality_signals before drafting.",
+        research: "Start from Wiki Entries, then inspect related_refs and Source Cards when evidence or source context matters.",
+        decision: "Use matches to recover constraints, prior judgments, and rejected alternatives before making or revising a choice.",
+        review: "Use result_quality, match_reasons, quality_signals, and warnings to decide whether the knowledge is ready or needs enrichment."
+    };
+}
 function finalizeQuality(result) {
     const all = Object.values(result.matches).flat();
     result.result_quality = {

package/docs/AGENT_HANDOFF.md

@@ -174,6 +174,8 @@ If `fetch_status` is `failed`, say that AIWiki recorded the failure reason but d
 
 ## Query Protocol
 
+Call AIWiki context before writing, researching, deciding, or reviewing when the user asks you to reuse knowledge from this workspace. This includes drafting from prior notes, comparing evidence, recovering project constraints, checking rejected alternatives, or validating whether a match is strong enough to cite.
+
 When the user asks what AIWiki knows about a topic, call:
 
 ```bash
@@ -196,6 +198,7 @@ Read these fields before responding:
 - `match_reasons`
 - `quality_signals`
 - `related_refs`
+- `reuse_guidance`
 
 Do not scan `02-raw` by default unless the Wiki result is insufficient, the user asks to verify the original text, or sources conflict.
 

package/docs/USAGE.md

@@ -185,6 +185,13 @@ For human-readable terminal output:
 aiwiki query "<topic>"
 ```
 
+Use query/context before the assistant writes, researches, decides, or reviews:
+
+- Writing: retrieve prior angles, outlines, source-backed points, and quality warnings before drafting.
+- Research: start from Wiki Entries, then follow `related_refs` and Source Cards when evidence matters.
+- Decisions: recover constraints, prior judgments, and rejected alternatives before changing direction.
+- Review: check `result_quality`, `match_reasons`, `quality_signals`, and warnings before treating a match as reusable knowledge.
+
 Useful filters:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itradingai/aiwiki",
-  "version": "0.2.24",
+  "version": "0.2.25",
   "type": "module",
   "description": "Local Markdown knowledge base for AI assistants. Save what your AI reads, ask it later, and keep everything local.",
   "license": "MIT",

package/skill/SKILL.md

@@ -3,7 +3,7 @@ name: aiwiki
 description: Local Markdown knowledge base workflow for AI assistants.
 ---
 
-<!-- aiwiki-skill-version: 0.2.22 -->
+<!-- aiwiki-skill-version: 0.2.25 -->
 
 # AIWiki Skill
 
@@ -202,6 +202,8 @@ If `fetch_status` is `failed`, say that AIWiki recorded the failure reason but d
 
 ## Query Protocol
 
+Call AIWiki context before writing, researching, deciding, or reviewing when the user asks you to reuse knowledge from this workspace. This includes drafting from prior notes, comparing evidence, recovering project constraints, checking rejected alternatives, or validating whether a match is strong enough to cite.
+
 When the user asks to understand a topic from AIWiki, call:
 
 ```bash
@@ -224,6 +226,7 @@ Use the returned JSON to answer. Prefer Wiki Entries first, but read these field
 - `match_reasons`: why each result matched
 - `quality_signals`: scaffold, enriched, grounding, status, and relationship hints
 - `related_refs`: local wikilinks and frontmatter relationships
+- `reuse_guidance`: how to apply the result to writing, research, decisions, and review
 
 Do not scan `02-raw` by default unless the Wiki result is insufficient, the user asks to verify the original text, or sources conflict.