Compare commits
2
Commits
74cf0310b4
...
9c2f19b579
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
9c2f19b579 | ||
|
|
9c913829ab |
@@ -1,9 +1,9 @@
|
|||||||
# Memory Index
|
# Memory Index
|
||||||
> _Last synced: 2026-05-01 | Base commit: `0c46ed0`_
|
> _Last synced: 2026-05-08 | Base commit: `9c91382`_
|
||||||
|
|
||||||
| 文件 | 描述 | 类型 | 引用 | Commit |
|
| 文件 | 描述 | 类型 | 引用 | Commit |
|
||||||
|------|------|------|------|--------|
|
|------|------|------|------|--------|
|
||||||
| decisions.md | 关键架构决策:无版本号/userConfig/Bearer Token/SKILL.md规范 | project | 1 | 0c46ed0 |
|
| decisions.md | 关键架构决策:无版本号/userConfig/Bearer Token/SKILL.md规范/路径锁定 | project | 1 | 9c91382 |
|
||||||
| project_overview.md | 项目定位、目录结构、插件规范、发布流程 | project | 1 | 0c46ed0 |
|
| project_overview.md | 项目定位、目录结构、插件规范、发布流程(huanxi/memcore/obsidian) | project | 1 | 9c91382 |
|
||||||
| feedback_plugin_dev.md | 插件开发协作规范:同步四处/路径解析/工具签名对照 | feedback | 0 | 0c46ed0 |
|
| feedback_plugin_dev.md | 插件开发协作规范:同步四处/路径解析/工具签名对照 | feedback | 0 | 0c46ed0 |
|
||||||
| lint_report.md | memory-lint 最新执行结果 | lint | 0 | 0c46ed0 |
|
| lint_report.md | memory-lint 最新执行结果 | lint | 0 | 0c46ed0 |
|
||||||
|
|||||||
@@ -2,8 +2,8 @@
|
|||||||
name: 架构决策
|
name: 架构决策
|
||||||
description: Marketplace 设计中的关键技术决策及其原因
|
description: Marketplace 设计中的关键技术决策及其原因
|
||||||
type: project
|
type: project
|
||||||
last_updated: 2026-05-01
|
last_updated: 2026-05-08
|
||||||
commit: 0c46ed0
|
commit: 9c91382
|
||||||
---
|
---
|
||||||
|
|
||||||
# 关键架构决策
|
# 关键架构决策
|
||||||
@@ -51,6 +51,18 @@ commit: 0c46ed0
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## memcore memory-update/lint 路径锁定:禁止写入系统自动记忆路径
|
||||||
|
|
||||||
|
**结论**:`memory-update` 和 `memory-lint` 的唯一操作路径锁定为 `$PROJECT_DIR/.claude/memory/`;严禁写入 `~/.claude/projects/*/memory/`;两个技能执行期间不触发 auto memory 系统写入。
|
||||||
|
|
||||||
|
**Why**:Claude Code 的 auto memory 是 system-level 指令,在技能执行期间始终有效。若技能只在 description 中说"不推送远程"而无显式路径约束,AI 会在执行 memory-update/lint 时被 auto memory 指令并发触发,将内容写入系统级路径(`~/.claude/projects/xxx/memory/`),背离"项目本地 .claude/memory/ 是唯一权威"的初衷。
|
||||||
|
|
||||||
|
**How to apply**:两个技能均在正文最前加"⚠ 路径锁定"块(含禁止路径清单 + 执行前断言代码),memory-sync 的 Phase 3 加方向锁定注释(Phase 10 是唯一远程写入窗口)。未来新增操作本地记忆的技能也应遵循同等约束。
|
||||||
|
|
||||||
|
**See Also**:[[project_overview.md#已发布插件]]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## SKILL.md frontmatter 只保留 name 和 description
|
## SKILL.md frontmatter 只保留 name 和 description
|
||||||
|
|
||||||
**结论**:SKILL.md frontmatter 只写 `name` 和 `description` 两个字段,去掉 `version`。
|
**结论**:SKILL.md frontmatter 只写 `name` 和 `description` 两个字段,去掉 `version`。
|
||||||
|
|||||||
@@ -2,28 +2,27 @@
|
|||||||
name: 记忆健康检查报告
|
name: 记忆健康检查报告
|
||||||
description: memory-lint 最新一次执行的检查结果与待处理项
|
description: memory-lint 最新一次执行的检查结果与待处理项
|
||||||
type: lint
|
type: lint
|
||||||
last_updated: 2026-05-01
|
last_updated: 2026-05-08
|
||||||
---
|
---
|
||||||
|
|
||||||
# 记忆健康检查报告
|
# 记忆健康检查报告
|
||||||
|
|
||||||
> _执行时间: 2026-05-01 | Base commit: `0c46ed0` | Last synced: 2026-05-01_
|
> _执行时间: 2026-05-08 | Base commit: `9c91382` | Last synced: 2026-05-08_
|
||||||
|
|
||||||
## 健康概览
|
## 健康概览
|
||||||
|
|
||||||
| 检查项 | AUTO-FIX | NEED-HUMAN |
|
| 检查项 | AUTO-FIX | NEED-HUMAN |
|
||||||
|--------|---------|-----------|
|
|--------|---------|-----------|
|
||||||
| 1 孤儿 / 2 幽灵 / 3A 引用 / 3B 双链 | 0 / 0 / 0 / 1 | — / — / 0 / 0 |
|
| 1 孤儿 / 2 幽灵 / 3A 引用 / 3B 双链 | 0 / 0 / 0 / 0 | — / — / 0 / 0 |
|
||||||
| 4 矛盾 / 5 过期 / 6 污染 | — | 0 / 0 / 0 |
|
| 4 矛盾 / 5 过期 / 6 污染 | — | 0 / 0 / 0 |
|
||||||
|
|
||||||
**AUTO-FIX 已执行 1 项 | NEED-HUMAN 待处理 0 项**
|
**AUTO-FIX 已执行 0 项 | NEED-HUMAN 待处理 0 项**
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## AUTO-FIX 已执行清单
|
## AUTO-FIX 已执行清单
|
||||||
|
|
||||||
- [x] 补入反向链接:`project_overview.md → ## 已发布插件` 末尾追加 `See Also: [[decisions.md#...]]`
|
无
|
||||||
- [x] MEMORY.md「引用」列已刷新(3 文件,按引用倒序)
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -2,8 +2,8 @@
|
|||||||
name: 项目概述
|
name: 项目概述
|
||||||
description: yixiong-claude-marketplace 的定位、目录结构、插件规范和发布流程
|
description: yixiong-claude-marketplace 的定位、目录结构、插件规范和发布流程
|
||||||
type: project
|
type: project
|
||||||
last_updated: 2026-05-01
|
last_updated: 2026-05-08
|
||||||
commit: 0c46ed0
|
commit: 9c91382
|
||||||
---
|
---
|
||||||
|
|
||||||
# 蚁熊内部 Claude Code Marketplace
|
# 蚁熊内部 Claude Code Marketplace
|
||||||
@@ -62,6 +62,7 @@ description: "触发描述(用户实际口语,不用内部视角)"
|
|||||||
|------|------|------|
|
|------|------|------|
|
||||||
| `huanxi` | 6 个(report/leader/task/weekly/org/shared) | userConfig Bearer Token + MCP Server |
|
| `huanxi` | 6 个(report/leader/task/weekly/org/shared) | userConfig Bearer Token + MCP Server |
|
||||||
| `memcore` | 3 个(memory-sync/lint/update) | 纯技能,无 MCP |
|
| `memcore` | 3 个(memory-sync/lint/update) | 纯技能,无 MCP |
|
||||||
|
| `obsidian` | 9 个(obsidian/bases/daily/history/meta/plugins/search/tasks/workflow-pkm) | 纯技能,无 MCP |
|
||||||
|
|
||||||
**See Also**:[[decisions.md#huanxi plugin 使用 userConfig 而非环境变量传 Token]]
|
**See Also**:[[decisions.md#huanxi plugin 使用 userConfig 而非环境变量传 Token]]
|
||||||
|
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
<!-- Last updated: 2026-05-01 | Commit: 0c46ed0 -->
|
<!-- Last updated: 2026-05-08 | Commit: 9c91382 -->
|
||||||
# CLAUDE.md
|
# CLAUDE.md
|
||||||
|
|
||||||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||||||
@@ -78,6 +78,7 @@ description: 一句话说明该技能的用途(Claude 用此判断何时触发
|
|||||||
|------|------|------|
|
|------|------|------|
|
||||||
| `huanxi` | `/huanxi-shared` `/huanxi-report` `/huanxi-leader` `/huanxi-task` `/huanxi-weekly` `/huanxi-org` | 寰汐企业管理系统完整工作流,含 MCP Server 自动配置 |
|
| `huanxi` | `/huanxi-shared` `/huanxi-report` `/huanxi-leader` `/huanxi-task` `/huanxi-weekly` `/huanxi-org` | 寰汐企业管理系统完整工作流,含 MCP Server 自动配置 |
|
||||||
| `memcore` | `/memory-sync` `/memory-update` `/memory-lint` | 项目记忆体系核心引擎 |
|
| `memcore` | `/memory-sync` `/memory-update` `/memory-lint` | 项目记忆体系核心引擎 |
|
||||||
|
| `obsidian` | `/obsidian` `/obsidian-bases` `/obsidian-daily` `/obsidian-history` `/obsidian-meta` `/obsidian-plugins` `/obsidian-search` `/obsidian-tasks` `/obsidian-workflow-pkm` | Obsidian 知识库完整工作流(9 个技能) |
|
||||||
|
|
||||||
### memcore 技能调用关系
|
### memcore 技能调用关系
|
||||||
|
|
||||||
|
|||||||
@@ -1,11 +1,33 @@
|
|||||||
---
|
---
|
||||||
name: memory-lint
|
name: memory-lint
|
||||||
description: 检查本地记忆文件的健康状况。AUTO-FIX类问题直接修改本地文件,NEED-HUMAN类问题写入lint_report.md。以本地.claude/memory/为唯一权威,不推送远程。可独立执行,也作为/memory-sync流程的一部分。调用命令: /memory-lint
|
description: 检查本地记忆文件的健康状况。AUTO-FIX类问题直接修改本地文件,NEED-HUMAN类问题写入lint_report.md。唯一操作路径为 $PROJECT_DIR/.claude/memory/,严禁读写 ~/.claude/projects/*/memory/ 等项目目录外的任何路径,也不触发 auto memory 系统写入。可独立执行,也作为/memory-sync流程的一部分。调用命令: /memory-lint
|
||||||
---
|
---
|
||||||
|
|
||||||
# memory-lint
|
# memory-lint
|
||||||
|
|
||||||
健康检查 `.claude/memory/`:AUTO-FIX 直修,NEED-HUMAN 写入 `lint_report.md`。**本地权威,不推送远程**。会话目录 = `$PROJECT_DIR`。
|
健康检查 `.claude/memory/`:AUTO-FIX 直修,NEED-HUMAN 写入 `lint_report.md`。会话目录 = `$PROJECT_DIR`。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠ 路径锁定(执行前必读)
|
||||||
|
|
||||||
|
**唯一操作路径**:`$PROJECT_DIR/.claude/memory/`(项目根目录内的 `.claude/memory/`)
|
||||||
|
|
||||||
|
**严禁读写的路径**:
|
||||||
|
- `~/.claude/projects/*/memory/`(系统自动记忆路径,由 auto memory 系统单独管理)
|
||||||
|
- `~/.claude/` 下任何其他目录
|
||||||
|
- 项目目录(`$PROJECT_DIR`)以外的任何路径
|
||||||
|
|
||||||
|
**不触发 auto memory**:本技能执行期间产生的所有 lint 修正和报告,均**不写入** auto memory 系统(`~/.claude/projects/{PROJECT_KEY}/memory/`),该路径仅由 `/memory-sync` 的 Phase 10 统一管理。
|
||||||
|
|
||||||
|
**执行前断言**:
|
||||||
|
```bash
|
||||||
|
TARGET="$PROJECT_DIR/.claude/memory"
|
||||||
|
echo "memory-lint 目标路径:$TARGET"
|
||||||
|
case "$TARGET" in *"/.claude/projects/"*)
|
||||||
|
echo "ERROR: 路径含系统自动记忆目录,中止" && exit 1 ;;
|
||||||
|
esac
|
||||||
|
```
|
||||||
|
|
||||||
目录不存在 → 输出 `⚠ 未找到 .claude/memory/,建议先执行 /memory-sync` 并终止。
|
目录不存在 → 输出 `⚠ 未找到 .claude/memory/,建议先执行 /memory-sync` 并终止。
|
||||||
|
|
||||||
|
|||||||
@@ -53,6 +53,8 @@ ls "$PROJECT_DIR/.claude/memory/" 2>/dev/null
|
|||||||
|
|
||||||
## Phase 3 — 远程 → 本地(只补不覆)
|
## Phase 3 — 远程 → 本地(只补不覆)
|
||||||
|
|
||||||
|
> **方向锁定**:本 Phase 唯一操作是从 `~/.claude/projects/{PROJECT_KEY}/memory/` 补充到 `$PROJECT_DIR/.claude/memory/`(缺失文件单向复制)。Phase 5(memory-update)和 Phase 6(memory-lint)严禁反向写入远程路径,所有远程同步只由 Phase 10 统一执行。
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
for f in ~/.claude/projects/{PROJECT_KEY}/memory/*.md; do
|
for f in ~/.claude/projects/{PROJECT_KEY}/memory/*.md; do
|
||||||
fn=$(basename "$f"); local="$PROJECT_DIR/.claude/memory/$fn"
|
fn=$(basename "$f"); local="$PROJECT_DIR/.claude/memory/$fn"
|
||||||
|
|||||||
@@ -1,11 +1,35 @@
|
|||||||
---
|
---
|
||||||
name: memory-update
|
name: memory-update
|
||||||
description: 根据git diff增量范围,更新本地记忆文件和MEMORY.md索引。以本地.claude/memory/为唯一权威,不推送远程。可独立执行,也作为/memory-sync流程的一部分。调用命令: /memory-update
|
description: 根据git diff增量范围,更新本地记忆文件和MEMORY.md索引。唯一操作路径为 $PROJECT_DIR/.claude/memory/,严禁写入 ~/.claude/projects/*/memory/ 等项目目录外的任何路径,也不触发 auto memory 系统写入。可独立执行,也作为/memory-sync流程的一部分。调用命令: /memory-update
|
||||||
---
|
---
|
||||||
|
|
||||||
# memory-update
|
# memory-update
|
||||||
|
|
||||||
按 git diff 增量更新本地 `.claude/memory/`。**本地权威,仅操作本地文件**。会话目录 = `$PROJECT_DIR`;目录不存在则 `mkdir -p`。
|
按 git diff 增量更新本地 `.claude/memory/`。会话目录 = `$PROJECT_DIR`;目录不存在则 `mkdir -p`。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠ 路径锁定(执行前必读)
|
||||||
|
|
||||||
|
**唯一操作路径**:`$PROJECT_DIR/.claude/memory/`(项目根目录内的 `.claude/memory/`)
|
||||||
|
|
||||||
|
**严禁写入的路径**:
|
||||||
|
- `~/.claude/projects/*/memory/`(系统自动记忆路径,由 auto memory 系统单独管理)
|
||||||
|
- `~/.claude/` 下任何其他目录
|
||||||
|
- 项目目录(`$PROJECT_DIR`)以外的任何路径
|
||||||
|
|
||||||
|
**不触发 auto memory**:本技能执行期间产生的所有记忆内容,均**不写入** auto memory 系统(`~/.claude/projects/{PROJECT_KEY}/memory/`),该路径仅由 `/memory-sync` 的 Phase 10 统一管理。
|
||||||
|
|
||||||
|
**执行前断言**:
|
||||||
|
```bash
|
||||||
|
# 确认目标路径在项目目录内
|
||||||
|
TARGET="$PROJECT_DIR/.claude/memory"
|
||||||
|
echo "memory-update 目标路径:$TARGET"
|
||||||
|
# 路径含 .claude/projects 则中止
|
||||||
|
case "$TARGET" in *"/.claude/projects/"*)
|
||||||
|
echo "ERROR: 路径含系统自动记忆目录,中止" && exit 1 ;;
|
||||||
|
esac
|
||||||
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user