Files

T

SkyJourneyandClaude Opus 4.7 38beecb2d0 feat(huanxi+memcore): 全量修正 huanxi 技能描述漂移 + memcore 七项优化

- huanxi: 更新 MCP URL 至 huanxi.office.yixiong-tech.com
- huanxi: 修正所有技能与后端 docstring 漂移
  · report items 字段表（补 module_id 必填、progress→progress_update、去除虚构 status）
  · weekly_report_save week→week_number
  · task end_date（非 due_date）、critical（非 urgent）、not_started（非 todo）
  · 用户/模块 ID 字段名统一为 id（非 user_id）
  · 所有 references 顶部声明"参数细节以 MCP docstring 为准"
- memcore: 新增 memcore-shared 共享层（路径锁定 + 全局常量 + PROJECT_DIR 跨平台解析）
- memcore: lint_report 增量保活（NEED-HUMAN 稳定 ID + resolved 跳过）
- memcore: synonyms.md 自动登记入索引
- memcore: SYNTHESIS_THRESHOLD / LINT_STALE_*_DAYS / MULTI_HOST_WARN_DAYS 常量化
- memcore: update Phase 1 增加 Base commit 兜底，防锚点丢失雪崩
- memcore: Phase 3C 引用快扫脚本改用 grep -F + -- 兼容中文/空格 title

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-06-12 19:13:21 +08:00

4.3 KiB

Raw Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

项目概述

蚁熊公司内部 Claude Code Plugin Marketplace（技能市场）。开发者在此仓库中维护供全员安装使用的 Claude Code 插件（Plugin）和技能（Skill）。

目录结构

.claude-plugin/
└── marketplace.json          # 市场索引：声明本仓库包含哪些插件

plugins/
└── <plugin-name>/            # 每个插件独占一个子目录
    ├── .claude-plugin/
    │   └── plugin.json       # 插件元数据（name, description, version, author）
    └── skills/
        └── <skill-name>/
            └── SKILL.md      # 技能实现（frontmatter + Markdown 指令）

核心文件格式

marketplace.json（市场索引）

{
  "name": "yixiong-claude-hub",
  "owner": { "name": "蚁熊团队" },
  "description": "...",
  "plugins": [
    { "name": "<plugin-name>", "source": "./plugins/<plugin-name>", "description": "..." }
  ]
}

每新增一个插件，必须在 plugins 数组中追加对应条目。

plugin.json（插件元数据）

{
  "name": "plugin-name",
  "description": "...",
  "author": { "name": "蚁熊团队" }
}

不设 version 字段：Claude Code 自动用 git commit SHA 作为版本基准，每次推送 main 分支即为新版本，已安装用户会话启动时自动检测更新。

含 MCP Server 的插件额外支持 userConfig（用户敏感配置，存系统钥匙链）和 mcpServers（服务器声明），可在 headers 中用 ${user_config.KEY} 引用用户配置。

SKILL.md（技能实现）

---
description: 一句话说明该技能的用途（Claude 用此判断何时触发该技能）
---

技能的具体指令内容…

description 字段是触发判据，务必精确描述使用场景，避免与其他技能产生歧义。

新增插件流程

在 plugins/ 下创建目录 plugins/<plugin-name>/
创建 plugins/<plugin-name>/.claude-plugin/plugin.json
在 plugins/<plugin-name>/skills/<skill-name>/SKILL.md 编写技能
在 .claude-plugin/marketplace.json 的 plugins 数组中追加该插件条目

已发布插件

插件	技能	说明
`huanxi`	`/huanxi-shared` `/huanxi-report` `/huanxi-leader` `/huanxi-task` `/huanxi-weekly` `/huanxi-org`	寰汐企业管理系统完整工作流，含 MCP Server 自动配置
`memcore`	`/memory-sync` `/memory-update` `/memory-lint` `/memcore-shared`（内部 include）	项目记忆体系核心引擎
`obsidian`	`/obsidian` `/obsidian-bases` `/obsidian-daily` `/obsidian-history` `/obsidian-meta` `/obsidian-plugins` `/obsidian-search` `/obsidian-tasks` `/obsidian-workflow-pkm`	Obsidian 知识库完整工作流（9 个技能）

memcore 技能调用关系

/memcore-shared ← 内部 include（路径锁定 + 全局常量 + PROJECT_DIR 解析），不由用户直接调用
       ↑ Read 引用
       │
/memory-sync   ← 总编排（11 phases），调用下面两个技能
  ├── /memory-update  ← 增量写入，可独立执行
  └── /memory-lint    ← 健康校验，可独立执行

关键常量统一来源（修改 memcore-shared 一处即可全局生效）：

SYNTHESIS_THRESHOLD = 3（synthesis 升级跨文件引用阈值）
LINT_STALE_WARN_DAYS = 30 / LINT_STALE_ERROR_DAYS = 90（过期阈值）
MULTI_HOST_WARN_DAYS = 7（多机不同步预警阈值）

记忆体系（会话启动必读）

每次新会话或长会话压缩后，必须先读 MEMORY.md 索引再按需加载文件。代码与记忆冲突 → 以代码为准并更新记忆。

读取流程

cat .claude/memory/MEMORY.md 获取清单
必读（type=project/feedback）：decisions.md / feedback_plugin_dev.md / project_overview.md
按需（type=lint）：lint_report.md

记忆目录骨架

.claude/memory/
├── MEMORY.md                    # 索引（入口）
├── decisions.md                 # 关键架构决策
├── project_overview.md          # 项目定位与结构
├── feedback_plugin_dev.md       # 插件开发协作规范
└── lint_report.md               # 记忆健康检查报告（按需）

4.3 KiB Raw Blame History Unescape Escape