@memo-code/memo 0.7.2 → 0.8.0

package/README.md

@@ -5,18 +5,22 @@
 </div>
 
 <p align="center">
-  <a href="README.zh.md">Chinese Documentation</a>
+  <a href="https://github.com/minorcell/memo-code/actions/workflows/ci.yml">
+    <img src="https://github.com/minorcell/memo-code/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI">
+  </a>
+  <a href="https://codecov.io/gh/minorcell/memo-code">
+    <img src="https://codecov.io/gh/minorcell/memo-code/graph/badge.svg" alt="Coverage">
+  </a>
+  <a href="https://www.npmjs.com/package/@memo-code/memo">
+    <img src="https://img.shields.io/npm/v/%40memo-code%2Fmemo" alt="npm version">
+  </a>
 </p>
 
 <p align="center">
-  <a href="public/memo-code-cli-show-01.mp4">
-    <img src="https://img.shields.io/badge/📹-Watch%20Demo%20Video-1a1a1a?style=for-the-badge" alt="Demo Video">
-  </a>
+  <a href="README.zh.md">Chinese Documentation</a>
 </p>
 
----
-
-<video src="public/memo-code-cli-show-01.mp4" width="100%"></video>
+<img src="public/demo.png" width="100%" alt="Memo Code demo">
 
 Built with Node.js + TypeScript. DeepSeek is the default provider, and OpenAI-compatible APIs are supported.
 
@@ -56,6 +60,7 @@ memo
 - Dangerous mode: `memo --dangerous` or `memo -d` (skip tool approvals; use carefully).
 - Version: `memo --version` or `memo -v`.
 - Startup project guidance: if `AGENTS.md` exists in the startup root, Memo appends it to the system prompt automatically.
+- Skills: Memo auto-discovers `SKILL.md` files and appends an available-skills section into the system prompt.
 - MCP activation selection: when MCP servers are configured, startup shows a multi-select to activate servers for this run.
 - Session titles: Memo generates a short title from the first user prompt and uses it in history/resume lists.
 
@@ -77,6 +82,24 @@ base_url = "https://api.deepseek.com"
 
 You can configure multiple providers and switch with `current_provider`.
 
+Optional: override model capability profiles (local capability gating) without code changes:
+
+```toml
+[model_profiles.gpt-5]
+supports_parallel_tool_calls = true
+supports_reasoning_content = true
+context_window = 272000
+
+[model_profiles."openai:gpt-5"]
+supports_parallel_tool_calls = false # provider-specific override
+```
+
+Context window policy:
+
+- priority 1: `model_profiles."provider:model".context_window`
+- priority 2: `model_profiles."<model>".context_window`
+- fallback: `120000`
+
 ### MCP Tool Configuration
 
 Both local and remote MCP servers are supported:
@@ -115,6 +138,33 @@ memo mcp get remote
 memo mcp remove remote
 ```
 
+## Skills
+
+Memo supports Agent Skills and auto-discovers `SKILL.md` files at startup.
+
+### Discovery Paths
+
+- Project scope: project root `.<agent>/skills` directories (for example: `.agents/skills`, `.claude/skills`, `.codex/skills`)
+- User scope: `$MEMO_HOME/skills` (or `~/.memo/skills`)
+- Not scanned: `~/.xxx/skills` hidden directories outside Memo home
+
+### Minimal Skill File
+
+```md
+---
+name: doc-writing
+description: Generate and update technical documentation.
+---
+
+# Doc Writing
+```
+
+Memo reads `name` and `description` from frontmatter and injects each skill as metadata:
+
+- `- <name>: <description> (file: <absolute-path-to-SKILL.md>)`
+
+In prompts, users can explicitly mention a skill with `$skill-name` (for example, `$doc-writing`).
+
 ## Built-in Tools
 
 - `exec_command` / `write_stdin`: execute shell commands (default shell family)
@@ -143,15 +193,13 @@ Memo includes a tool-approval mechanism to reduce risky operations:
 
 ## Session History
 
-All sessions are saved to `~/.memo/sessions/`, grouped by date:
+All sessions are saved to `~/.memo/sessions/`, grouped by project absolute path:
 
 ```text
 ~/.memo/sessions/
-  └── 2026/
-      └── 02/
-          └── 08/
-              ├── rollout-2026-02-08T02-21-18-abc123.jsonl
-              └── rollout-2026-02-08T02-42-09-def456.jsonl
+  └── -Users-mcell-Desktop-workspace-memo-code/
+      ├── 2026-02-08T02-21-18-abc123.jsonl
+      └── 2026-02-08T02-42-09-def456.jsonl
 ```
 
 JSONL format is useful for analysis and debugging.
@@ -175,6 +223,7 @@ pnpm run build  # generates dist/index.js
 
 ```bash
 pnpm test            # all tests
+pnpm run test:coverage  # all tests with coverage (threshold: >=70%)
 pnpm run test:core   # core package
 pnpm run test:tools  # tools package
 pnpm run test:tui    # tui package
@@ -203,7 +252,7 @@ memo-cli/
 
 - `/help`: show help and shortcut guide.
 - `/models`: list available Provider/Model entries and switch with Enter; also supports direct selection like `/models deepseek`.
-- `/context`: open 80k/120k/150k/200k options and apply immediately.
+- `/review <prNumber>`: run GitHub PR review and publish review comments (uses active GitHub MCP server first, then falls back to `gh` CLI).
 - `/mcp`: show configured MCP servers in current session.
 - `resume` history: type `resume` to list and load past sessions for current directory.
 - Exit and clear: `exit` / `/exit`, `Ctrl+L` for new session, `Esc Esc` to cancel current run or clear input.

package/README.zh.md

@@ -5,14 +5,18 @@
 </div>
 
 <p align="center">
-  <a href="public/memo-code-cli-show-01.mp4">
-    <img src="https://img.shields.io/badge/📹-观看演示视频-1a1a1a?style=for-the-badge" alt="Demo Video">
+  <a href="https://github.com/minorcell/memo-code/actions/workflows/ci.yml">
+    <img src="https://github.com/minorcell/memo-code/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI">
+  </a>
+  <a href="https://codecov.io/gh/minorcell/memo-code">
+    <img src="https://codecov.io/gh/minorcell/memo-code/graph/badge.svg" alt="Coverage">
+  </a>
+  <a href="https://www.npmjs.com/package/@memo-code/memo">
+    <img src="https://img.shields.io/npm/v/%40memo-code%2Fmemo" alt="npm version">
   </a>
 </p>
 
----
-
-<video src="public/memo-code-cli-show-01.mp4" width="100%"></video>
+<img src="public/demo.png" width="100%" alt="Memo Code 演示图">
 
 基于 Node.js + TypeScript，默认对接 DeepSeek，兼容 OpenAI API。
 
@@ -52,6 +56,7 @@ memo
 - 危险模式：`memo --dangerous` 或 `memo -d`（跳过工具审批，谨慎使用）。
 - 查看版本：`memo --version` 或 `memo -v`。
 - 启动目录约定：若启动根目录存在 `AGENTS.md`，Memo 会自动将其拼接进系统提示词。
+- Skills：Memo 会自动发现 `SKILL.md` 并把可用 skills 列表拼接进系统提示词。
 - MCP 启动选择：当配置了 MCP server 时，启动会弹出多选以决定本次会话激活哪些 server。
 - 会话标题：Memo 会基于首条用户输入生成简短标题，并在历史/恢复列表中展示。
 
@@ -111,6 +116,33 @@ memo mcp get remote
 memo mcp remove remote
 ```
 
+## Skills
+
+Memo 支持 Agent Skills，并会在启动时自动发现 `SKILL.md`。
+
+### 发现路径
+
+- 项目级：项目根目录下 `.<agent>/skills`（例如：`.agents/skills`、`.claude/skills`、`.codex/skills`）
+- 用户级：`$MEMO_HOME/skills`（或 `~/.memo/skills`）
+- 不扫描：Memo Home 之外的 `~/.xxx/skills` 隐藏目录
+
+### 最小 Skill 文件示例
+
+```md
+---
+name: doc-writing
+description: Generate and update technical documentation.
+---
+
+# Doc Writing
+```
+
+Memo 会读取 frontmatter 的 `name` 和 `description`，并以元数据形式注入：
+
+- `- <name>: <description> (file: <absolute-path-to-SKILL.md>)`
+
+在对话里可通过 `$skill-name` 显式提及某个 skill（例如 `$doc-writing`）。
+
 ## 内置工具
 
 - `exec_command` / `write_stdin`：执行命令（默认执行工具族）
@@ -139,15 +171,13 @@ memo mcp remove remote
 
 ## 会话历史
 
-所有会话自动保存到 `~/.memo/sessions/`，按日期分层组织：
+所有会话自动保存到 `~/.memo/sessions/`，按项目绝对路径分层组织：
 
 ```
 ~/.memo/sessions/
-  └── 2026/
-      └── 02/
-          └── 08/
-              ├── rollout-2026-02-08T02-21-18-abc123.jsonl
-              └── rollout-2026-02-08T02-42-09-def456.jsonl
+  └── -Users-mcell-Desktop-workspace-memo-code/
+      ├── 2026-02-08T02-21-18-abc123.jsonl
+      └── 2026-02-08T02-42-09-def456.jsonl
 ```
 
 JSONL 格式便于分析和调试。
@@ -171,6 +201,7 @@ pnpm run build  # 生成 dist/index.js
 
 ```bash
 pnpm test            # 全量测试
+pnpm run test:coverage  # 带覆盖率测试（阈值：>=70%）
 pnpm run test:core   # 测试 core 包
 pnpm run test:tools  # 测试 tools 包
 pnpm run test:tui    # 测试 tui 包
@@ -200,6 +231,7 @@ memo-cli/
 - `/help`：显示帮助与快捷键说明。
 - `/models`：列出现有 Provider/Model，回车切换；支持直接 `/models deepseek` 精确选择。
 - `/context`：弹出 80k/120k/150k/200k 选项并立即设置上限。
+- `/review <prNumber>`：执行 GitHub PR 审查并直接发布评论（优先使用已激活的 GitHub MCP，失败时回退 `gh` CLI）。
 - `/mcp`：查看当前会话加载的 MCP 服务器配置。
 - `resume` 历史：输入 `resume` 查看并加载本目录的历史会话。
 - 退出与清屏：`exit` / `/exit`，`Ctrl+L` 新会话，`Esc Esc` 取消运行或清空输入。