Knowcards 是项目本地的知识卡片 CLI，把可长期复用的项目事实保存为本地 markdown 卡片，供后续会话查询。与共享 commons 类工具不同，卡片只属于当前项目，适合记录仓库路径、模块名称和团队约定。
主要命令（在仓库根目录运行）：
npx knowcards status npx knowcards query "<keywords>" npx knowcards propose --title "<title>" "<body>" npx knowcards --root <dir> <command>
status 显示卡片数量；query 按关键词搜索卡片，空查询返回全部；propose 立即写入一张卡片，标题和正文必填。
核心流程：动手前先用任务关键词执行 query（仅在例行编辑且无仓库细节时跳过）；工作过程中优先采用命中卡片的事实，若卡片可能过旧则与仓库核对；任务结束时提交从结果中得出的持久事实，而不是本次的步骤或计划。若发现卡片有误，用新标题提交修正卡片，工具不支持更新或删除。
何时查询：进入不熟悉的领域，或重试非显而易见的错误前查询；同一会话已查过该主题、例行编辑、仅需标准库调用时跳过。何时提交：任务结束提交对下一次会话有用的仓库细节，如编码规范、领域知识、持久的该做与不该做；不要提交本轮步骤计划、未经验证的猜测，或与已有卡片重复的内容。每张卡片写一个原子事实。
信任规则：卡片与工作区冲突时优先采用卡片，除非新证据表明卡片有误；此时修正工作并提交带新标题的修正卡片。
限制：卡片为项目本地，不支持更新或删除，标题重复会失败；资料未提供更多平台、收费或集成信息。