@topmindspace/topmind-skills 4.13.3 → 4.13.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/INSTALL.md +1 -1
- package/README.en.md +1 -1
- package/README.md +2 -2
- package/evals/evals.json +5 -5
- package/install-targets/claude-code.json +1 -1
- package/install-targets/codex.json +1 -1
- package/install-targets/hermes.json +1 -1
- package/install-targets/mimocode.json +4 -4
- package/install-targets/opencode.json +1 -1
- package/install-targets/universal.json +3 -3
- package/integrations/codex/README.md +4 -4
- package/integrations/hermes/README.md +4 -4
- package/integrations/opencode/README.md +3 -3
- package/integrations/opencode/plugins/topmind-plugin.ts +1 -1
- package/integrations/opencode/tests/opencode-config-shape.test.mjs +3 -1
- package/package.json +1 -1
- package/shared/document-ingest.md +1 -1
- package/shared/host-loading.md +7 -7
- package/skills.md +1 -1
- package/topmind/SKILL.md +2 -2
- package/topmind-capture/SKILL.md +1 -1
- package/topmind-ledger/SKILL.md +1 -1
- package/topmind-loop/DESIGN.md +1 -1
- package/topmind-loop/SKILL.md +1 -1
- package/topmind-maintain/SKILL.md +1 -1
- package/topmind-memory/SKILL.md +9 -7
- package/topmind-organize/SKILL.md +1 -1
- package/topmind-pack.json +26 -10
- package/topmind-wechat/DESIGN.md +1 -1
- package/topmind-wechat/SKILL.md +1 -1
- package/topmind-wechat/references/workflow.md +9 -9
- package/topmind-weread/SKILL.md +1 -1
- package/topmind-write/SKILL.md +1 -1
- package/topmind-x/SKILL.md +1 -1
package/INSTALL.md
CHANGED
|
@@ -231,7 +231,7 @@ push tag `v*` 后 CI 自动:
|
|
|
231
231
|
1. 测试 + 打包
|
|
232
232
|
2. 创建 GitHub Release(附 zip / tar.gz / manifest / SHA256SUMS / latest.json)
|
|
233
233
|
3. `npm publish` → [`@topmindspace/topmind-skills`](https://www.npmjs.com/package/@topmindspace/topmind-skills)(需仓库 Secret `NPM_TOKEN`,Automation token)
|
|
234
|
-
4. **只保留最近 2 个 GitHub Release
|
|
234
|
+
4. **只保留最近 2 个 GitHub Release**(删旧 Release 与附件)。git tag 保留。
|
|
235
235
|
|
|
236
236
|
| 渠道 | 触发 | 自动 |
|
|
237
237
|
|------|------|------|
|
package/README.en.md
CHANGED
|
@@ -67,7 +67,7 @@ topmind-skills/ # pack root = repo root
|
|
|
67
67
|
```text
|
|
68
68
|
User experience: capture-first
|
|
69
69
|
Data organization: category-first + topic-emerges
|
|
70
|
-
Content truth: topmind-workspace
|
|
70
|
+
Content truth: topmind-workspace
|
|
71
71
|
Capability model: action-first
|
|
72
72
|
Save settings: auto | confirm
|
|
73
73
|
Safety model: reversible by default
|
package/README.md
CHANGED
|
@@ -67,7 +67,7 @@ topmind-skills/ # pack 根 = 仓库根
|
|
|
67
67
|
```text
|
|
68
68
|
User experience: capture-first
|
|
69
69
|
Data organization: category-first + topic-emerges
|
|
70
|
-
Content truth: topmind-workspace
|
|
70
|
+
Content truth: topmind-workspace
|
|
71
71
|
Capability model: action-first
|
|
72
72
|
Save settings: auto | confirm
|
|
73
73
|
Safety model: reversible by default
|
|
@@ -163,7 +163,7 @@ degradation: ../shared/capability-degradation.md
|
|
|
163
163
|
|
|
164
164
|
## 安装目标
|
|
165
165
|
|
|
166
|
-
已打包的 skill 目录(7 个核心 + 2 个可选连接器 +
|
|
166
|
+
已打包的 skill 目录(7 个核心 + 2 个可选连接器 + 可选记账 + 可选公众号 `topmind-wechat`)可以符号链接或复制到 Claude Code、Codex、OpenCode、Hermes 等。
|
|
167
167
|
优先使用 npm / pack-aware 安装器,保证 `shared/` 与 `topmind-pack.json` 完整 — 见 [`INSTALL.md`](./INSTALL.md)。
|
|
168
168
|
|
|
169
169
|
```bash
|
package/evals/evals.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"skill_name": "topmind",
|
|
3
3
|
"daily_entry": "topmind",
|
|
4
|
-
"version": "4.13.
|
|
4
|
+
"version": "4.13.5",
|
|
5
5
|
"evals": [
|
|
6
6
|
{
|
|
7
7
|
"id": 1,
|
|
@@ -112,28 +112,28 @@
|
|
|
112
112
|
"prompt": "跑一遍 topmind-loop,做整体巡检。",
|
|
113
113
|
"primary_skill": "topmind-loop",
|
|
114
114
|
"extra_skills": [],
|
|
115
|
-
"expected_output": "Routes through topmind-loop (independent skill, not a maintain sub-action), walks all topics/inbox/archive scopes, applies well-defined fixes via UTR commands, writes decisions to .loop/topics.md, and flags architecture drift signals."
|
|
115
|
+
"expected_output": "Routes through topmind-loop (independent skill, not a maintain sub-action), walks all topics/inbox/archive scopes, applies well-defined fixes via UTR commands, writes decisions to .topmind/loop/topics.md, and flags architecture drift signals."
|
|
116
116
|
},
|
|
117
117
|
{
|
|
118
118
|
"id": 16,
|
|
119
119
|
"prompt": "继续 loop,从上次断点恢复。",
|
|
120
120
|
"primary_skill": "topmind-loop",
|
|
121
121
|
"extra_skills": [],
|
|
122
|
-
"expected_output": "Routes through topmind-loop, reads cursor from .loop/{scope}.md state files, resumes walk at the cursor item, updates done/total and cursor after each item, and appends new decisions."
|
|
122
|
+
"expected_output": "Routes through topmind-loop, reads cursor from .topmind/loop/{scope}.md state files, resumes walk at the cursor item, updates done/total and cursor after each item, and appends new decisions."
|
|
123
123
|
},
|
|
124
124
|
{
|
|
125
125
|
"id": 17,
|
|
126
126
|
"prompt": "loop 一下 20-研究 大类下的所有专题。",
|
|
127
127
|
"primary_skill": "topmind-loop",
|
|
128
128
|
"extra_skills": [],
|
|
129
|
-
"expected_output": "Routes through topmind-loop with scoped walk (only 20-研究 category topics), writes scoped progress to .loop/topics.md, applies UTR fixes for well-defined issues, escalates ambiguous decisions to Errors/Blockers."
|
|
129
|
+
"expected_output": "Routes through topmind-loop with scoped walk (only 20-研究 category topics), writes scoped progress to .topmind/loop/topics.md, applies UTR fixes for well-defined issues, escalates ambiguous decisions to Errors/Blockers."
|
|
130
130
|
},
|
|
131
131
|
{
|
|
132
132
|
"id": 18,
|
|
133
133
|
"prompt": "[schema validation] Verify all SKILL.md files have required frontmatter fields: name, version, description, action_category, triggers. Verify action_category values are within the enum. Verify name matches directory name in kebab-case.",
|
|
134
134
|
"primary_skill": "topmind-maintain",
|
|
135
135
|
"extra_skills": [],
|
|
136
|
-
"expected_output": "Validates frontmatter schema across all SKILL.md files (
|
|
136
|
+
"expected_output": "Validates frontmatter schema across all SKILL.md files (11 total: 7 core + 2 connector + optional ledger + optional wechat). Reports any missing required fields, invalid action_category values, or name/directory mismatches."
|
|
137
137
|
},
|
|
138
138
|
{
|
|
139
139
|
"id": 19,
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
"capabilities": [
|
|
30
30
|
"skills"
|
|
31
31
|
],
|
|
32
|
-
"content_truth": "topmind-workspace
|
|
32
|
+
"content_truth": "topmind-workspace",
|
|
33
33
|
"host_must_not": [
|
|
34
34
|
"change-content-truth",
|
|
35
35
|
"add-daily-entrypoints",
|
|
@@ -43,8 +43,8 @@
|
|
|
43
43
|
"workspace_root": "host-provided"
|
|
44
44
|
},
|
|
45
45
|
"notes": [
|
|
46
|
-
"MiMoCode / MiMo Desktop: project root .mimocode/skills, global root
|
|
47
|
-
"Brand root
|
|
46
|
+
"MiMoCode / MiMo Desktop: project root .mimocode/skills, global root <mimocode-global-skills>.",
|
|
47
|
+
"Brand root <agents-skills> may also be scanned — canonical install already covers it.",
|
|
48
48
|
"Single daily entry topmind. v4.3 progressive disclosure."
|
|
49
49
|
],
|
|
50
50
|
"install": {
|
|
@@ -54,6 +54,6 @@
|
|
|
54
54
|
"matrix": "node bin/install-skills.mjs add topmindspace/topmind-skills -g -a mimocode",
|
|
55
55
|
"from_git": "node bin/install-skills.mjs add topmindspace/topmind-skills -g -a mimocode",
|
|
56
56
|
"from_release": "node bin/install-skills.mjs add release:latest -g -a mimocode",
|
|
57
|
-
"single_dir": "node bin/install-skills.mjs add topmindspace/topmind-skills --dest
|
|
57
|
+
"single_dir": "node bin/install-skills.mjs add topmindspace/topmind-skills --dest <mimocode-global-skills>"
|
|
58
58
|
}
|
|
59
59
|
}
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
"capabilities": [
|
|
30
30
|
"skills"
|
|
31
31
|
],
|
|
32
|
-
"content_truth": "topmind-workspace
|
|
32
|
+
"content_truth": "topmind-workspace",
|
|
33
33
|
"host_must_not": [
|
|
34
34
|
"change-content-truth",
|
|
35
35
|
"add-daily-entrypoints",
|
|
@@ -42,7 +42,7 @@
|
|
|
42
42
|
"skills_root": ".agents/skills"
|
|
43
43
|
},
|
|
44
44
|
"notes": [
|
|
45
|
-
"Open standard root: project ./.agents/skills, global
|
|
45
|
+
"Open standard root: project ./.agents/skills, global <agents-skills>.",
|
|
46
46
|
"Agents whose project skillsDir is .agents/skills (Codex, Cursor, Gemini CLI, Warp, Zed, …) read this directly.",
|
|
47
47
|
"This is the canonical pack body. Private hosts symlink into it."
|
|
48
48
|
],
|
|
@@ -53,6 +53,6 @@
|
|
|
53
53
|
"matrix": "node bin/install-skills.mjs add topmindspace/topmind-skills -g -a universal",
|
|
54
54
|
"from_git": "node bin/install-skills.mjs add topmindspace/topmind-skills -g -a universal",
|
|
55
55
|
"from_release": "node bin/install-skills.mjs add release:latest -g -a universal",
|
|
56
|
-
"single_dir": "node bin/install-skills.mjs add topmindspace/topmind-skills --dest
|
|
56
|
+
"single_dir": "node bin/install-skills.mjs add topmindspace/topmind-skills --dest <agents-skills>"
|
|
57
57
|
}
|
|
58
58
|
}
|
|
@@ -1,19 +1,19 @@
|
|
|
1
1
|
# topmind · Codex Integration
|
|
2
2
|
|
|
3
|
-
[简体中文](../../README.md) · [English](../../README.en.md) · [Skills install](../../
|
|
3
|
+
[简体中文](../../README.md) · [English](../../README.en.md) · [Skills install](../../INSTALL.md)
|
|
4
4
|
|
|
5
5
|
Codex consumes topmind through the same portable skill pack as other hosts.
|
|
6
6
|
|
|
7
7
|
## Recommended route
|
|
8
8
|
|
|
9
|
-
1. Install or symlink the skills declared in `
|
|
9
|
+
1. Install or symlink the skills declared in `topmind-pack.json`.
|
|
10
10
|
2. **Expose only `topmind`** as the daily user-facing entry; sub-skills are internal.
|
|
11
11
|
3. Use `topmind-cli` or MCP when available; **UTR is optional** — otherwise host file tools with the same filesystem contract.
|
|
12
|
-
4. Keep all user data under `topmind-workspace
|
|
12
|
+
4. Keep all user data under `topmind-workspace`. Codex session state must not become topmind content truth.
|
|
13
13
|
|
|
14
14
|
## Portable contract
|
|
15
15
|
|
|
16
|
-
- Content truth is `topmind-workspace
|
|
16
|
+
- Content truth is `topmind-workspace`.
|
|
17
17
|
- Daily entry is `topmind`; no parallel daily entrypoints.
|
|
18
18
|
- **Desktop is not required** for the skill pack.
|
|
19
19
|
- Naming and frontmatter follow `PROJECT-MODEL.md` / `TOOLS.md`.
|
|
@@ -1,19 +1,19 @@
|
|
|
1
1
|
# topmind · Hermes Integration
|
|
2
2
|
|
|
3
|
-
[简体中文](../../README.md) · [English](../../README.en.md) · [Skills install](../../
|
|
3
|
+
[简体中文](../../README.md) · [English](../../README.en.md) · [Skills install](../../INSTALL.md)
|
|
4
4
|
|
|
5
5
|
Hermes consumes topmind as a portable skill pack, not a second workspace model.
|
|
6
6
|
|
|
7
7
|
## Recommended route
|
|
8
8
|
|
|
9
|
-
1. Install or symlink the skills declared in `
|
|
9
|
+
1. Install or symlink the skills declared in `topmind-pack.json`.
|
|
10
10
|
2. **Expose only `topmind`** as the daily entry; sub-skills route internally.
|
|
11
11
|
3. **UTR is optional** — use CLI/MCP when available; otherwise host file tools with the same filesystem contract.
|
|
12
|
-
4. Keep user data under `topmind-workspace
|
|
12
|
+
4. Keep user data under `topmind-workspace`. Hermes-specific state must not become topmind content truth.
|
|
13
13
|
|
|
14
14
|
## Portable contract
|
|
15
15
|
|
|
16
|
-
- Content truth is `topmind-workspace
|
|
16
|
+
- Content truth is `topmind-workspace`.
|
|
17
17
|
- Daily entry is `topmind`; no parallel daily entrypoints.
|
|
18
18
|
- **Desktop is not required** for the skill pack.
|
|
19
19
|
- Naming and frontmatter follow `PROJECT-MODEL.md` / `TOOLS.md`.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
# topmind · OpenCode Integration
|
|
2
2
|
|
|
3
|
-
[简体中文](../../README.md) · [English](../../README.en.md) · [Skills install](../../
|
|
3
|
+
[简体中文](../../README.md) · [English](../../README.en.md) · [Skills install](../../INSTALL.md)
|
|
4
4
|
|
|
5
5
|
topmind should not fork OpenCode by default. Prefer a thin adapter layer.
|
|
6
6
|
|
|
7
7
|
## Recommended route
|
|
8
8
|
|
|
9
|
-
1. Install the portable skill pack (`
|
|
9
|
+
1. Install the portable skill pack (`topmind-pack.json` / pack-aware installer).
|
|
10
10
|
2. **Expose only `topmind`** as the daily user-facing entry — sub-skills are internal.
|
|
11
11
|
3. Expose UTR through MCP when available; **UTR is optional** otherwise use host file tools.
|
|
12
12
|
4. Optional OpenCode commands for common capture and doctor flows (`commands/`).
|
|
13
|
-
5. Keep content truth in `topmind-workspace
|
|
13
|
+
5. Keep content truth in `topmind-workspace`. OpenCode state must not become topmind content truth.
|
|
14
14
|
|
|
15
15
|
## Config shape
|
|
16
16
|
|
|
@@ -9,7 +9,7 @@ export default async function topmindPlugin(app?: OpenCodeApp) {
|
|
|
9
9
|
|
|
10
10
|
return {
|
|
11
11
|
name: "topmind",
|
|
12
|
-
contentTruth: "topmind-workspace
|
|
12
|
+
contentTruth: "topmind-workspace",
|
|
13
13
|
dailyEntry: "topmind",
|
|
14
14
|
writesContent: false,
|
|
15
15
|
capabilities: ["skills", "mcp", "commands", "plugin"],
|
|
@@ -57,7 +57,9 @@ test("OpenCode adapter follows the portable skill-pack contract", async () => {
|
|
|
57
57
|
assert.match(readme, /content truth/u);
|
|
58
58
|
assert.match(readme, /Expose only `topmind`|only daily.*`topmind`/iu);
|
|
59
59
|
|
|
60
|
-
|
|
60
|
+
const truth = String(pack.portable_contract.content_truth).replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
61
|
+
assert.match(pluginSource, new RegExp(`contentTruth:\\s*"${truth}"`));
|
|
62
|
+
assert.doesNotMatch(pluginSource, /categories-and-topics/u);
|
|
61
63
|
assert.match(pluginSource, /writesContent:\s*false/u);
|
|
62
64
|
assert.doesNotMatch(readme + "\n" + pluginSource, /should fork OpenCode|write topmind content directly:\s*true|writesContent:\s*true/u);
|
|
63
65
|
});
|
package/package.json
CHANGED
|
@@ -59,7 +59,7 @@ ingest_converter: anydoc@0.1.8 | markitdown@… | pptx-ooxml
|
|
|
59
59
|
|
|
60
60
|
失败时原件导入 + 说明笔记;可选原件进 `99-归档/ingest-originals/`。
|
|
61
61
|
|
|
62
|
-
相关:网页剪藏分层见 [`long-url-capture.md`](./long-url-capture.md);能力勾选见 [
|
|
62
|
+
相关:网页剪藏分层见 [`long-url-capture.md`](./long-url-capture.md);能力勾选见 [`capture-clip-matrix.md`](https://github.com/topmindspace/topmind/blob/main/docs/capture-clip-matrix.md)。
|
|
63
63
|
|
|
64
64
|
## 格式与本机工具
|
|
65
65
|
|
package/shared/host-loading.md
CHANGED
|
@@ -11,15 +11,15 @@
|
|
|
11
11
|
| **2 Activation** | 匹配到任务 | 完整 `SKILL.md` body | < 5k tokens 推荐 |
|
|
12
12
|
| **3 Resources** | 步骤需要时 | `shared/*.md` · `references/*` · 可选 scripts | 按需 |
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
**禁止**:启动时把全部 SKILL 全文 + shared 全部塞进 system prompt。
|
|
15
15
|
|
|
16
16
|
## 组合式 Pack 如何被 Host 理解
|
|
17
17
|
|
|
18
|
-
topmind 是 **multi-skill pack
|
|
18
|
+
topmind 是 **multi-skill pack**(目录与 `topmind-pack.json` 的 `skills` 一一对应,含 router、action、connector、可选 ledger 与可选 wechat write 子技能),不是单文件 skill。业界对齐:
|
|
19
19
|
|
|
20
20
|
| 约定 | topmind 做法 |
|
|
21
21
|
|------|----------------|
|
|
22
|
-
| Agent Skills 单 skill = `{name}/SKILL.md` |
|
|
22
|
+
| Agent Skills 单 skill = `{name}/SKILL.md` | 11 个目录各有 `SKILL.md` |
|
|
23
23
|
| 部分 host 对 **zip 根** 找 `SKILL.md` | Release zip 根额外含 **router `SKILL.md`**(= `topmind/SKILL.md`) |
|
|
24
24
|
| Pack 索引 | `skills.md` / `topmind-pack.json`(人类 + 机器) |
|
|
25
25
|
| 共享资源 | `shared/` 与 skill 目录**同级** |
|
|
@@ -42,7 +42,7 @@ topmind-skills-<ver>/ ← Release zip 顶层
|
|
|
42
42
|
│ └── SKILL.md
|
|
43
43
|
├── topmind-capture/
|
|
44
44
|
│ └── SKILL.md
|
|
45
|
-
├── …(其余
|
|
45
|
+
├── …(其余 9 个,含可选 topmind-weread / topmind-x / topmind-ledger / topmind-wechat)
|
|
46
46
|
├── shared/ ← 与 skill 同级!相对链接 ../shared/ 才能解析
|
|
47
47
|
│ ├── capability-degradation.md
|
|
48
48
|
│ ├── project-model-brief.md
|
|
@@ -56,7 +56,7 @@ topmind-skills-<ver>/ ← Release zip 顶层
|
|
|
56
56
|
|
|
57
57
|
### 错误形状
|
|
58
58
|
|
|
59
|
-
- 只拷了
|
|
59
|
+
- 只拷了 skill 目录、**没有** `shared/` → 渐进链接 404
|
|
60
60
|
- 把 monorepo 整仓当 skill 根 → host 扫到无关目录
|
|
61
61
|
- 只装 `topmind` 却期望 weread/x 触发 → connector 未装
|
|
62
62
|
- Host 报 `SKILL.md not found`:请用 `topmind-skills-*.zip`(含根 `SKILL.md`),或装到 `{skillsRoot}/topmind/SKILL.md`
|
|
@@ -76,7 +76,7 @@ topmind-skills-<ver>/ ← Release zip 顶层
|
|
|
76
76
|
node bin/install-skills.mjs add topmindspace/topmind-skills -g
|
|
77
77
|
|
|
78
78
|
# 或手动
|
|
79
|
-
cp -R
|
|
79
|
+
cp -R shared ~/.agents/skills/shared
|
|
80
80
|
```
|
|
81
81
|
|
|
82
82
|
## Router vs 子 skill(Host 路由策略)
|
|
@@ -86,7 +86,7 @@ cp -R skills/shared ~/.agents/skills/shared
|
|
|
86
86
|
| 单一清晰动词(记一下 / 写一稿 / doctor) | 对应 `topmind-*` 子 skill |
|
|
87
87
|
| 多意图 / 模糊 / 只说「topmind」 | `topmind` router |
|
|
88
88
|
| Host **只装了** topmind 一个 skill | router 内嵌 Action Map 完成全部语义 |
|
|
89
|
-
|
|
|
89
|
+
| 子 skill 全部安装 | description 消歧;router **不抢** 已匹配的子 skill |
|
|
90
90
|
|
|
91
91
|
实现提示:discovery 阶段只比 `description` 文本相似度 / 关键词;**不要**用 triggers 数组作为唯一标准(triggers 是 topmind 扩展,开放标准不要求)。
|
|
92
92
|
|
package/skills.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# topmind Skills Package Index (包索引)
|
|
2
2
|
|
|
3
3
|
> [!NOTE]
|
|
4
|
-
> **每日唯一入口**:`topmind` (router)。其余 6 个 action、2 个 optional connector、1 个 optional
|
|
4
|
+
> **每日唯一入口**:`topmind` (router)。其余 6 个 action、2 个 optional connector、1 个 optional 记账模块、1 个 optional 公众号 write 子技能(共 11)均由 router 调度。
|
|
5
5
|
> **通用与可移植**:兼容 Claude Code / OpenCode / Codex / Hermes 等 Agent Host。
|
|
6
6
|
> **版本真源**:`topmind-pack.json`(可执行 `npm run versions` 查看完整版本号)。
|
|
7
7
|
> 详见权威说明:[Skills README](./README.md)(简体中文) · [English](./README.en.md) · [安装与部署指南 (INSTALL.md)](./INSTALL.md)。
|
package/topmind/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: topmind
|
|
3
|
-
version: 4.13.
|
|
3
|
+
version: 4.13.5
|
|
4
4
|
description: >-
|
|
5
5
|
topmind 总入口与多意图路由(类别/专题/笔记/交付)。Use when 用户说 topmind、意图模糊、或需要
|
|
6
6
|
收→整→写 分步。单意图明确时直接用 topmind-capture|organize|write|memory|maintain|loop|weread|x|ledger|wechat。
|
|
@@ -127,7 +127,7 @@ Connector:[`references/connector-resolution.md`](references/connector-resoluti
|
|
|
127
127
|
主路径:host 文件工具 + project-model-brief。Skills pack **不依赖** Pi / `pi-agent-core`;不要编造 bash / shell。宿主若有唯一片段替换,中段改稿优先用它。
|
|
128
128
|
降级:[`../shared/capability-degradation.md`](../shared/capability-degradation.md)。
|
|
129
129
|
|
|
130
|
-
UTR 可选(MCP primary+danger 共
|
|
130
|
+
UTR 可选(MCP primary+danger 共 23;注册表 32 = 8 域 / 32 命令,见 TOOLS.md):`list-categories` · `list-topics` · `inspect-topic` · `list-topic-files` · `list-inbox` · `create-topic` · `capture-note` · `save-output` · `contract.validate` · `contract.reseed` · `memory.promote` · `memory.digest` · `memory.append-profile` · `memory.append-topic` · `memory.retire-profile` · `memory.update-profile` · `memory.compact-history` · `memory.restore-profile` · `doctor-workspace` · `plan-inbox-routing` · `archive-topic` · `archive-stream-year` · `restore-safety-receipt`。
|
|
131
131
|
|
|
132
132
|
字段始终独立 **`category` + `topic`**(真实目录名,非写死编号)。
|
|
133
133
|
|
package/topmind-capture/SKILL.md
CHANGED
package/topmind-ledger/SKILL.md
CHANGED
package/topmind-loop/DESIGN.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
## Why Loop Exists
|
|
6
6
|
|
|
7
|
-
UTR 提供 **8 域 /
|
|
7
|
+
UTR 提供 **8 域 / 32** 条确定性命令;`doctor-workspace` 做规则健康检查。Loop 在之上增加**语义层**:阅读 `topic.md` 与笔记、对照 skill 契约、再调用 UTR 修复。
|
|
8
8
|
|
|
9
9
|
## Design Choice — Skill + Agent + State File, Not CLI
|
|
10
10
|
|
package/topmind-loop/SKILL.md
CHANGED
package/topmind-memory/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: topmind-memory
|
|
3
|
-
version: 4.13.
|
|
3
|
+
version: 4.13.5
|
|
4
4
|
description: >-
|
|
5
5
|
更新「我的情况」或周期反思。Use when 记住这个、更新我的情况、加到专题记忆、沉淀结论。
|
|
6
6
|
Do NOT use for 捕获、仅总结(→organize)、整理本周正文、出稿、开/并专题、doctor/loop.
|
|
@@ -23,7 +23,7 @@ compatibility: workspace core profile (memory/profile.md) + periodic reflections
|
|
|
23
23
|
author: TopMindSpace
|
|
24
24
|
license: MIT
|
|
25
25
|
homepage: https://github.com/topmindspace/topmind
|
|
26
|
-
updated: 2026-
|
|
26
|
+
updated: 2026-09-25
|
|
27
27
|
degradation: ../shared/capability-degradation.md
|
|
28
28
|
---
|
|
29
29
|
|
|
@@ -61,17 +61,19 @@ degradation: ../shared/capability-degradation.md
|
|
|
61
61
|
- 缺失时创建模板后追加
|
|
62
62
|
|
|
63
63
|
```text
|
|
64
|
-
UTR: memory.append-profile
|
|
65
|
-
Desktop: append_core_memory · update_core_memory · retire_core_memory
|
|
66
|
-
Host: 读 profile(活跃段)→ ADD / UPDATE 原位 / RETIRE 到 ## 历史记录 → 写回
|
|
64
|
+
UTR: memory.append-profile · memory.update-profile · memory.retire-profile · memory.restore-profile · memory.compact-history
|
|
65
|
+
Desktop: append_core_memory · update_core_memory · retire_core_memory · restore_core_memory · compact_core_memory_history
|
|
66
|
+
Host: 读 profile(活跃段)→ ADD / UPDATE 原位 / RETIRE 到 ## 历史记录 / RESTORE 回活跃 / COMPACT-HISTORY → 写回
|
|
67
67
|
```
|
|
68
68
|
|
|
69
69
|
**事实生命周期(确认式,无自动遗忘,不是只追加)**:
|
|
70
70
|
- **追加(ADD)**:新稳定事实 → `append_core_memory` / `memory.append-profile`(跨活跃段落去重,禁止第二条活事实)
|
|
71
|
-
- **更新(UPDATE)**:含义变了 → `update_core_memory
|
|
71
|
+
- **更新(UPDATE)**:含义变了 → `update_core_memory`(原位改写并刷新日期,旧表述进历史 `sup`,不要再 append 一行)
|
|
72
72
|
- **归档(RETIRE)**:已完成/过期 → `retire_core_memory`(活跃段 → `## 历史记录`,加 `(YYYY-MM-DD 归档)` 前缀,**不删内容**)
|
|
73
|
+
- **恢复(RESTORE)**:历史事实仍有效需重新生效 → `restore_core_memory`(历史 → 活跃段;若活跃已有等价事实则拒绝)
|
|
74
|
+
- **历史压缩(COMPACT-HISTORY)**:用户要求清理近重复历史行 → `compact_core_memory_history`(**需确认**;保留最新,丢更早近重复)
|
|
73
75
|
|
|
74
|
-
用户说「这件事做完了 / 这条过时了」→ 归档,**不要删除**;「这条改成…」→
|
|
76
|
+
用户说「这件事做完了 / 这条过时了」→ 归档,**不要删除**;「这条改成…」→ 原位更新;「这条还是对的,恢复」→ RESTORE。`memory_organize` 产出 `append_profile` / `update_profile` / `retire_profile` 建议(须确认)。AI 上下文只注入活跃事实(历史段折叠为计数)。
|
|
75
77
|
|
|
76
78
|
## 周期反思(Periodic)
|
|
77
79
|
|
package/topmind-pack.json
CHANGED
|
@@ -2,10 +2,10 @@
|
|
|
2
2
|
"schema_version": 1,
|
|
3
3
|
"name": "topmind",
|
|
4
4
|
"label": "topmind",
|
|
5
|
-
"description": "topmind skill pack: single daily entry topmind + progressive disclosure (shared/ + references/), Agent Skills open-standard aligned, capture-first template-driven categories, optional weread
|
|
5
|
+
"description": "topmind skill pack: single daily entry topmind + progressive disclosure (shared/ + references/), Agent Skills open-standard aligned, capture-first template-driven categories, optional connectors topmind-weread and topmind-x, optional topmind-ledger (记账), optional write sub-skill topmind-wechat. None of the optional skills is an extra user concept. File-system-first content truth; UTR optional.",
|
|
6
6
|
"daily_entry": "topmind",
|
|
7
|
-
"version": "4.13.
|
|
8
|
-
"updated": "2026-09-
|
|
7
|
+
"version": "4.13.5",
|
|
8
|
+
"updated": "2026-09-25",
|
|
9
9
|
"license": "MIT",
|
|
10
10
|
"locales": {
|
|
11
11
|
"default": "zh-CN",
|
|
@@ -72,7 +72,7 @@
|
|
|
72
72
|
],
|
|
73
73
|
"runtime": "pure-markdown",
|
|
74
74
|
"optional_dependencies": {
|
|
75
|
-
"utr": "node >=
|
|
75
|
+
"utr": "node >= 20.11, optional deterministic CLI/MCP commands",
|
|
76
76
|
"desktop": "Electron, optional GUI client (topmind-desktop/)"
|
|
77
77
|
}
|
|
78
78
|
},
|
|
@@ -216,7 +216,7 @@
|
|
|
216
216
|
"topic_emerges": true,
|
|
217
217
|
"action_first": true,
|
|
218
218
|
"single_user_entry": true,
|
|
219
|
-
"content_truth": "topmind-workspace
|
|
219
|
+
"content_truth": "topmind-workspace",
|
|
220
220
|
"inbox_role": "unassigned-capture",
|
|
221
221
|
"topic_role": "assigned-work",
|
|
222
222
|
"loose_note_role": "unfiled-but-categorized"
|
|
@@ -279,7 +279,7 @@
|
|
|
279
279
|
"portable_contract": {
|
|
280
280
|
"requires_desktop": false,
|
|
281
281
|
"requires_utr": false,
|
|
282
|
-
"content_truth": "topmind-workspace
|
|
282
|
+
"content_truth": "topmind-workspace",
|
|
283
283
|
"host_may_provide": [
|
|
284
284
|
"skills",
|
|
285
285
|
"cli",
|
|
@@ -313,6 +313,14 @@
|
|
|
313
313
|
{
|
|
314
314
|
"id": "claude-code",
|
|
315
315
|
"path": "install-targets/claude-code.json"
|
|
316
|
+
},
|
|
317
|
+
{
|
|
318
|
+
"id": "mimocode",
|
|
319
|
+
"path": "install-targets/mimocode.json"
|
|
320
|
+
},
|
|
321
|
+
{
|
|
322
|
+
"id": "universal",
|
|
323
|
+
"path": "install-targets/universal.json"
|
|
316
324
|
}
|
|
317
325
|
],
|
|
318
326
|
"utr": {
|
|
@@ -367,7 +375,11 @@
|
|
|
367
375
|
"promote",
|
|
368
376
|
"digest",
|
|
369
377
|
"append-profile",
|
|
370
|
-
"append-topic"
|
|
378
|
+
"append-topic",
|
|
379
|
+
"retire-profile",
|
|
380
|
+
"update-profile",
|
|
381
|
+
"compact-history",
|
|
382
|
+
"restore-profile"
|
|
371
383
|
],
|
|
372
384
|
"lifecycle": [
|
|
373
385
|
"scan"
|
|
@@ -376,8 +388,8 @@
|
|
|
376
388
|
"rebuild"
|
|
377
389
|
]
|
|
378
390
|
},
|
|
379
|
-
"command_count":
|
|
380
|
-
"mcp_default_count":
|
|
391
|
+
"command_count": 32,
|
|
392
|
+
"mcp_default_count": 23,
|
|
381
393
|
"command_exposure": {
|
|
382
394
|
"primary": [
|
|
383
395
|
"workspace-read.list-categories",
|
|
@@ -394,7 +406,11 @@
|
|
|
394
406
|
"memory.promote",
|
|
395
407
|
"memory.digest",
|
|
396
408
|
"memory.append-profile",
|
|
397
|
-
"memory.append-topic"
|
|
409
|
+
"memory.append-topic",
|
|
410
|
+
"memory.retire-profile",
|
|
411
|
+
"memory.update-profile",
|
|
412
|
+
"memory.compact-history",
|
|
413
|
+
"memory.restore-profile"
|
|
398
414
|
],
|
|
399
415
|
"danger": [
|
|
400
416
|
"workspace-maintain.archive-topic",
|
package/topmind-wechat/DESIGN.md
CHANGED
package/topmind-wechat/SKILL.md
CHANGED
|
@@ -91,12 +91,12 @@ python3 scripts/md2wechat.py --input <包>/公众号稿.md --out-dir <包> \
|
|
|
91
91
|
3. 提醒:外链只能进「阅读原文」;图已 base64 内嵌,占位符按清单补传
|
|
92
92
|
4. 需要进交付层时:`save-output` 拷贝终稿到 `88-交付/`(`YYYY-MM-DD-描述.ext`)
|
|
93
93
|
|
|
94
|
-
## Desktop
|
|
95
|
-
|
|
96
|
-
| 步骤 | Desktop「公众号创作」 |
|
|
97
|
-
|
|
98
|
-
| 建包/列表 | 扫工作区包根 |
|
|
99
|
-
| 改稿 |
|
|
100
|
-
| 三关 | AI 味 + lint + 事实勾选 |
|
|
101
|
-
| 排版 | 主题预览 + 调脚本导出 |
|
|
102
|
-
| 状态 | 调 `sync-status`
|
|
94
|
+
## Desktop
|
|
95
|
+
|
|
96
|
+
| 步骤 | Desktop「公众号创作」 |
|
|
97
|
+
|------|----------------------|
|
|
98
|
+
| 建包/列表 | 扫工作区包根 |
|
|
99
|
+
| 改稿 | 写闸回执 |
|
|
100
|
+
| 三关 | AI 味 + lint + 事实勾选 |
|
|
101
|
+
| 排版 | 主题预览 + 调脚本导出 |
|
|
102
|
+
| 状态 | 调 `sync-status` |
|
package/topmind-weread/SKILL.md
CHANGED
package/topmind-write/SKILL.md
CHANGED