learn

01 前言 Front Matter

args

[ "{{action}}", "{{topic}}", "{{note}}" ]

name

learn

schema

{ "note": { "type": "string", "description": "Single-line lesson learned (add only). Concise. No outer \"- \" (added automatically). Examples — \"AX tree depth ≥ 6 to see number buttons\", \"cmd+N + type more reliable than ui click 'New Note'\", \"AXError -25205 means the element is offscreen / collapsed\".\n" }, "topic": { "type": "string", "description": "Section header to file the note under (add) or look up (recall) — typically a bundle_id like \"com.apple.calculator\", \"com.apple.Notes\", or a generic category like \"Common: focus protection\". Required for add and recall.\n" }, "action": { "type": "string", "description": "add (default) | recall | list. add appends a note; recall prints one topic's section; list prints the topic index.\n" } }

command

[ "sh", "-c", "ACTION=\"${1:-add}\"\nTOPIC=\"$2\"\nNOTE=\"$3\"\nFILE=\"$HOME/.kinclaw/learned.md\"\nmkdir -p \"$HOME/.kinclaw\"\n[ -f \"$FILE\" ] || printf '# KinClaw — learned across sessions\\n\\n' > \"$FILE\"\n\ncase \"$ACTION\" in\n list)\n # Topic index: every ## header with its bullet count.\n awk '/^## /{ if (t!=\"\") printf \"%s (%d)\\n\", t, n; t=substr($0,4); n=0; next }\n /^- /{ n++ }\n END{ if (t!=\"\") printf \"%s (%d)\\n\", t, n }' \"$FILE\"\n exit 0 ;;\n recall)\n [ -z \"$TOPIC\" ] && { echo \"topic required for recall\" >&2; exit 1; }\n OUT=$(awk -v q=\"$(printf '%s' \"$TOPIC\" | tr 'A-Z' 'a-z')\" '\n /^## /{ inhit = index(tolower(substr($0,4)), q) > 0 }\n inhit { print }' \"$FILE\")\n [ -z \"$OUT\" ] && { echo \"no section matching: $TOPIC (try action=list)\"; exit 0; }\n printf '%s\\n' \"$OUT\"\n exit 0 ;;\n add|\"\") ;;\n *) echo \"action must be add | recall | list (got $ACTION)\" >&2; exit 1 ;;\nesac\n\n[ -z \"$TOPIC\" ] && { echo \"topic required\" >&2; exit 1; }\n[ -z \"$NOTE\" ] && { echo \"note required\" >&2; exit 1; }\n\n# Idempotent: if exact line already exists, no-op. The `--` is\n# important — leading \"- \" in $LINE would otherwise get parsed as\n# a grep flag. Same for the section header check below.\nLINE=\"- $NOTE\"\nif grep -Fq -- \"$LINE\" \"$FILE\" 2>/dev/null; then\n echo \"already known: $TOPIC :: $NOTE\"\n exit 0\nfi\n\n# Append to existing section if header exists, else create section.\nHEADER=\"## $TOPIC\"\nif grep -Fqx -- \"$HEADER\" \"$FILE\"; then\n # Insert line right after the section header using awk so order is preserved.\n awk -v hdr=\"$HEADER\" -v line=\"$LINE\" '\n $0 == hdr { print; print line; next }\n { print }\n ' \"$FILE\" > \"$FILE.new\" && mv \"$FILE.new\" \"$FILE\"\nelse\n printf '\\n%s\\n%s\\n' \"$HEADER\" \"$LINE\" >> \"$FILE\"\nfi\necho \"learned: $TOPIC :: $NOTE\"\n", "_" ]

timeout

10

description

The agent's cross-session notebook at ~/.kinclaw/learned.md, organized by bundle_id / topic. The kernel reads it at every boot and injects it into the system prompt (when it outgrows the prompt budget you see a topic index plus the newest notes — use action=recall for the rest). action=add (default) — append one lesson after a task: - AX schema quirks (depth needed, weird matchers) - Working keyboard / shell shortcuts that beat ui clicks - Failed approaches + their error codes (so you don't retry next time) - First-launch modal patterns - bundle_id spelling (some apps use lowercase like com.apple.mail) action=recall topic=X — print one section (case-insensitive match) action=list — print the topic index Appends go to a section keyed on `topic` (usually a bundle_id). Creates the section if it doesn't exist; appends bullet lines if it does. No-op if the exact same line already exists (idempotent).

03 SKILL.md 正文

learn topic=com.apple.calculator note="AX tree depth ≥ 6 to see number buttons"
learn topic=com.apple.Notes note="cmd+N more reliable than ui click 'New Note'"
learn topic=com.apple.reminders note="ui click description='Add Reminder' fails with AXError -25205; use cmd+N + type"
learn topic="Common: focus protection" note="osascript activate from Terminal-driven KinClaw rarely takes frontmost"
learn action=list
learn action=recall topic=com.apple.Notes