npm - @alanwang-merit/meritdata-platform-skill-package - Versions diffs - 1.0.2 → 1.0.3 - Mend

@alanwang-merit/meritdata-platform-skill-package 1.0.2 → 1.0.3

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.

Files changed (12) hide show

package/tools/skill-authoring-workflow/README.md DELETED Viewed

@@ -1,260 +0,0 @@
-# skill-authoring-workflow
-> 新建 skill 的标准工作流：模板 + 校验清单 + 流程。
----
-## 1. 新建 skill 流程
-```
-1. 选定 layer / sub-layer / stack
-       ↓
-2. 复制模板
-       ↓
-3. 填 SKILL.md frontmatter
-       ↓
-4. 写触发 / 不触发 / 前置约束 / 路由
-       ↓
-5. 编写 references/*.md（详细文档）
-       ↓
-6. 运行 skill-vetter 校验
-       ↓
-7. 提交 PR
-       ↓
-8. 架构组 review
-```
-## 2. 模板
-### 2.1 SKILL.md 模板
-```yaml
----
-name: meritdata-platform-<topic>
-description: <一句话描述 + 触发关键词>。当用户说"<关键词1> / <关键词2> / <关键词3>"时使用。
-metadata:
-  version: "1.0.0"
-  risk: low|medium|high
-  layer: L1 | L2 | L3 | L4
-  sub-layer: L2-M | L2-C | L2-F | L3-C | L3-F | L4-T
-  stack: methodology | java | frontend | tool
----
-# meritdata-platform-<topic>
-## 触发
-- 用户说"<关键词1>"
-- 用户说"<关键词2>"
-- <场景 3>
-- <场景 4>
-## 不触发
-- <场景 A>（→ `<其他 skill>`）
-- <场景 B>（→ `<其他 skill>`）
-- <场景 C>（→ `<其他 skill>`）
-## 前置约束
-- 必须先读 `<rules 文件 1>`
-- 必须遵守 `<rules 文件 2>` §章节
-- 必须引用 `<rules 文件 3>`
-## 路由
-- [guide.md](references/guide.md) — <一句话说明>
-- [topic-a.md](references/topic-a.md) — <一句话说明>
-- [topic-b.md](references/topic-b.md) — <一句话说明>
-```
-### 2.2 references/*.md 模板
-```markdown
-# <标题>
-> <一句话说明本文件主题>。
----
-## 1. <章节 1>
-<内容>
-### 1.1 <子章节>
-```java
-// 代码示例
-```
-### 1.2 <子章节>
-<内容>
-## 2. <章节 2>
-<内容>
----
-## ❌ 反模式
-### <反模式 1>
-```java
-// ❌ 错
-```
-```java
-// ✅ 正确
-```
----
-## 关联阅读
-- [guide.md](guide.md) — <一句话>
-- [SKILL.md](../SKILL.md)
-```
-详见 [templates/SKILL-template.md](templates/SKILL-template.md) 和 [templates/references-template.md](templates/references-template.md)。
-## 3. 命名规范
-### 3.1 Skill 命名
-```
-meritdata-platform-<topic>
-```
-| 类别 | 命名示例 |
-|------|---------|
-| L1 入口 | `meritdata-platform-playbook` |
-| L2 方法论 | `meritdata-platform-code-spec` |
-| L2 平台能力 | `meritdata-platform-bpm` |
-| L3 单点 API | `meritdata-platform-cache` |
-| L4 工具 | `meritdata-bootstrap-2nd-dev` |
-### 3.2 文件命名
-| 类型 | 规则 |
-|------|------|
-| SKILL.md | 固定名 |
-| references/ | kebab-case.md |
-| 索引文件 | guide.md / README.md |
-## 4. 前置约束写法
-**必须**引用 rules 文件，**禁止**重复 rules 正文：
-```markdown
-## 前置约束
-- 必须遵守 [`rules/code-dev-rules.md`](../../rules/code-dev-rules.md) §八
-- 必须遵守 [`rules/meritdata-platform-data-boundary.md`](../../rules/meritdata-platform-data-boundary.md) §1.1
-- 必须引用 [`rules/naming-conventions-rules.md`](../../rules/naming-conventions-rules.md)
-```
-## 5. 路由写法
-**必须**指向 `references/*.md`，**禁止**指向 rules：
-```markdown
-## 路由
-- [guide.md](references/guide.md) — 总览
-- [topic-a.md](references/topic-a.md) — 主题 A
-- [topic-b.md](references/topic-b.md) — 主题 B
-```
-## 6. 校验清单
-新建 skill 后，跑 [skill-vetter](../skill-vetter/README.md)：
-```bash
-bash tools/skill-vetter/run.sh meritdata-platform-new-skill
-```
-通过条件：
-- [ ] frontmatter 含所有必填字段
-- [ ] 4 大章节齐全（触发 / 不触发 / 前置约束 / 路由）
-- [ ] SKILL.md 行数 ≤ 60
-- [ ] references/ 至少 1 个文件
-- [ ] 前置约束引用 rules（不重复正文）
-- [ ] 路由指向 references/（不指向 rules）
-## 7. PR 模板
-```markdown
-## 新建 skill: meritdata-platform-<topic>
-**Layer**: L2-M / L2-C / L2-F / L3-C / L3-F / L4-T
-**Stack**: methodology / java / frontend / tool
-**Risk**: low / medium / high
-### 背景
-<为什么需要这个 skill>
-### 内容
-- SKILL.md（~38 行）：触发 / 不触发 / 前置约束 / 路由
-- references/guide.md：总览
-- references/topic-a.md：主题 A
-- references/topic-b.md：主题 B
-### 校验
-- [ ] skill-vetter 通过
-- [ ] 引用了正确的 rules
-- [ ] 没有重复 rules 正文
-### Reviewer
-@架构组
-```
-## 8. ❌ 反模式
-### 8.1 ❌ SKILL.md 直接写铁律
-```markdown
-❌ 错：
-## 数据访问边界
-1. 不映射 PF_ 平台表
-2. 不分页循环 Feign
-...
-✅ 正确：
-## 前置约束
-- 必须遵守 `rules/meritdata-platform-data-boundary.md`
-```
-### 8.2 ❌ references 写"是什么"
-```markdown
-❌ 错：
-# 缓存是什么
-缓存是一种...
-✅ 正确：
-# 多级缓存配置指南
-## 1. Caffeine L1 配置
-...
-```
-### 8.3 ❌ SKILL.md 行数过长
-```markdown
-❌ 错：SKILL.md 100 行（详情都在）
-✅ 正确：SKILL.md 38 行（路由），详情在 references/
-```
-## 9. 关联阅读
-- [templates/SKILL-template.md](templates/SKILL-template.md) — SKILL.md 模板
-- [templates/references-template.md](templates/references-template.md) — references 模板
-- [../skill-vetter/README.md](../skill-vetter/README.md) — 校验
-- [../skill-stocktake/README.md](../skill-stocktake/README.md) — 清单盘点

package/tools/skill-authoring-workflow/templates/SKILL-template.md DELETED Viewed

@@ -1,35 +0,0 @@
----
-name: meritdata-platform-<topic>
-description: <一句话描述，包含 3-5 个触发关键词>。当用户说"<kw1> / <kw2> / <kw3>"时使用。
-metadata:
-  version: "1.0.0"
-  risk: low
-  layer: L3
-  sub-layer: L3-C
-  stack: java
----
-# meritdata-platform-<topic>
-## 触发
-- 用户说"<kw1>"
-- 用户说"<kw2>"
-- <场景 3>
-- <场景 4>
-## 不触发
-- <场景 A>（→ `meritdata-platform-<other-skill>`）
-- <场景 B>（→ `meritdata-platform-<other-skill>`）
-## 前置约束
-- 必须遵守 [`rules/code-dev-rules.md`](../../rules/code-dev-rules.md)
-- 必须遵守 [`rules/naming-conventions-rules.md`](../../rules/naming-conventions-rules.md)
-## 路由
-- [guide.md](references/guide.md) — 总览
-- [topic-a.md](references/topic-a.md) — 主题 A
-- [topic-b.md](references/topic-b.md) — 主题 B

package/tools/skill-authoring-workflow/templates/references-template.md DELETED Viewed

@@ -1,59 +0,0 @@
-# <标题>
-> <一句话说明本文件主题>。
----
-## 1. <章节 1>
-<内容>
-### 1.1 <子章节>
-```java
-// 代码示例
-```
-### 1.2 <子章节>
-<内容>
-## 2. <章节 2>
-<内容>
-```java
-// 代码示例
-```
-## 3. <章节 3>
-### 3.1 <子章节>
-<内容>
----
-## ❌ 反模式
-### ❌ <反模式 1>
-```java
-// ❌ 错
-```
-```java
-// ✅ 正确
-```
-### ❌ <反模式 2>
-<说明>
----
-## 关联阅读
-- [guide.md](guide.md) — <一句话>
-- [SKILL.md](../SKILL.md)
-- [相关 rules](../../rules/<file>.md)

package/tools/skill-stocktake/README.md DELETED Viewed

@@ -1,121 +0,0 @@
-# skill-stocktake
-> 生成 meritdata-platform-suite 中所有 skill 的清单报告。
----
-## 用途
-- 套件盘点：了解当前 skill 全貌
-- 月度同步：统计 skill 数量 / 规模变化
-- 阶段验收：交付前的清单核查
-- 报告输出：JSON / Markdown 格式
-## 报告内容
-- 总数 + references 总行数
-- Layer / Sub-Layer / Stack 分布
-- 每个 skill 的：name / layer / sub-layer / stack / version / risk / SKILL.md 行数 / references 数量 / references 行数
-## 用法
-```bash
-# 控制台输出
-bash tools/skill-stocktake/run.sh
-# JSON 格式
-bash tools/skill-stocktake/run.sh json stocktake.json
-# Markdown 格式
-bash tools/skill-stocktake/run.sh markdown stocktake.md
-```
-## 输出示例（console）
-```
-========================================
-  skill-stocktake: skill 清单盘点
-========================================
-生成时间: 2026-09-07 18:30:00
-总数: 35 个 skill
-References 总行数: 12450
-Layer 分布:
-  L1      1
-  L2      13
-  L3      15
-  L4      3
-  L5      3
-Sub-Layer 分布:
-  L2-C    6
-  L2-F    1
-  L2-M    6
-  L3-C    13
-  L3-F    2
-  L4-T    3
-Skill 列表:
-  Name                                         Layer Sub     Stack        Ver
-  ---------------------------------------------------------------------------------
-  meritdata-platform-backend-deploy            L3    L3-C    java         1.0.0
-  meritdata-platform-bpm                       L2    L2-C    java         1.0.0
-  meritdata-platform-cache                     L3    L3-C    java         1.0.0
-  ...
-```
-## 输出示例（JSON）
-```json
-{
-  "scanTime": "2026-09-07 18:30:00",
-  "totalSkills": 35,
-  "totalRefLines": 12450,
-  "layers": {
-    "L1": 1,
-    "L2": 13,
-    "L3": 15,
-    "L4": 3
-  },
-  "subLayers": {
-    "L2-M": 6,
-    "L2-C": 6,
-    "L2-F": 1,
-    "L3-C": 13,
-    "L3-F": 2,
-    "L4-T": 3
-  },
-  "skills": [
-    {
-      "name": "meritdata-platform-cache",
-      "layer": "L3",
-      "subLayer": "L3-C",
-      "stack": "java",
-      "version": "1.0.0",
-      "risk": "medium",
-      "skillLines": 38,
-      "refCount": 3,
-      "refLines": 720,
-      "description": "多级缓存（Caffeine + Redis + DB）"
-    }
-  ]
-}
-```
-## 集成 CI
-```yaml
-# GitLab CI
-stocktake:
-  stage: report
-  script:
-    - bash tools/skill-stocktake/run.sh markdown stocktake.md
-  artifacts:
-    paths:
-      - stocktake.md
-```
-## 关联阅读
-- [../skill-vetter/README.md](../skill-vetter/README.md) — 校验工具
-- [../skill-authoring-workflow/README.md](../skill-authoring-workflow/README.md) — 编写规范

package/tools/skill-stocktake/run.sh DELETED Viewed

@@ -1,153 +0,0 @@
-#!/bin/bash
-# skill-stocktake: 生成 meritdata-platform-suite 中所有 skill 的清单报告
-#
-# 用法: bash tools/skill-stocktake/run.sh [output-format] [output-file]
-#   output-format: console | json | markdown (默认 console)
-#   output-file: 输出文件路径（默认 stdout）
-set -e
-SUITE_DIR="${SUITE_DIR:-$(cd "$(dirname "$0")/../.." && pwd)}"
-SKILLS_DIR="$SUITE_DIR/skills"
-FORMAT="${1:-console}"
-OUTPUT="${2:-}"
-NOW=$(date '+%Y-%m-%d %H:%M:%S')
-# 收集数据
-skills_data=()
-while IFS= read -r skill_dir; do
-    skill_name=$(basename "$skill_dir")
-    skill_md="$skill_dir/SKILL.md"
-    if [ ! -f "$skill_md" ]; then
-        continue
-    fi
-    layer=$(grep -E '^[[:space:]]+layer:' "$skill_md" | head -1 | sed 's/.*layer:[[:space:]]*//')
-    sub_layer=$(grep -E '^[[:space:]]+sub-layer:' "$skill_md" | head -1 | sed 's/.*sub-layer:[[:space:]]*//')
-    [ -z "$sub_layer" ] && sub_layer="(无)"
-    stack=$(grep -E '^[[:space:]]+stack:' "$skill_md" | head -1 | sed 's/.*stack:[[:space:]]*//')
-    [ -z "$stack" ] && stack="(无)"
-    version=$(grep -E '^[[:space:]]+version:' "$skill_md" | head -1 | sed "s/.*version:[[:space:]]*[\"']//;s/[\"']//")
-    risk=$(grep -E '^[[:space:]]+risk:' "$skill_md" | head -1 | sed 's/.*risk:[[:space:]]*//')
-    desc=$(grep -E '^description:' "$skill_md" | head -1 | sed 's/description:\s*//')
-    skill_lines=$(wc -l < "$skill_md")
-    ref_count=$(find "$skill_dir/references" -type f -name '*.md' 2>/dev/null | wc -l)
-    ref_lines=$(find "$skill_dir/references" -type f -name '*.md' 2>/dev/null -exec wc -l {} + 2>/dev/null | tail -1 | awk '{print $1}')
-    ref_lines=${ref_lines:-0}
-    skills_data+=("$skill_name|$layer|$sub_layer|$stack|$version|$risk|$skill_lines|$ref_count|$ref_lines|$desc")
-done < <(find "$SKILLS_DIR" -mindepth 1 -maxdepth 1 -type d | sort)
-total_count=${#skills_data[@]}
-total_ref_lines=0
-for line in "${skills_data[@]}"; do
-    total_ref_lines=$((total_ref_lines + $(echo "$line" | cut -d'|' -f9)))
-done
-# 按 layer / sub-layer 统计
-declare -A layer_count
-declare -A sub_layer_count
-declare -A stack_count
-for line in "${skills_data[@]}"; do
-    IFS='|' read -r _ l sl s _ _ _ _ _ _ <<< "$line"
-    layer_count[$l]=$((${layer_count[$l]:-0} + 1))
-    [ -n "$sl" ] && sub_layer_count[$sl]=$((${sub_layer_count[$sl]:-0} + 1))
-    [ -n "$s" ] && stack_count[$s]=$((${stack_count[$s]:-0} + 1))
-done
-# 输出
-output_text=""
-case "$FORMAT" in
-    json)
-        output_text+="{\n"
-        output_text+="  \"scanTime\": \"$NOW\",\n"
-        output_text+="  \"totalSkills\": $total_count,\n"
-        output_text+="  \"totalRefLines\": $total_ref_lines,\n"
-        output_text+="  \"layers\": {\n"
-        first=true
-        for key in "${!layer_count[@]}"; do
-            if [ "$first" = true ]; then first=false; else output_text+=",\n"; fi
-            output_text+="    \"$key\": ${layer_count[$key]}"
-        done
-        output_text+="\n  },\n"
-        output_text+="  \"subLayers\": {\n"
-        first=true
-        for key in "${!sub_layer_count[@]}"; do
-            if [ "$first" = true ]; then first=false; else output_text+=",\n"; fi
-            output_text+="    \"$key\": ${sub_layer_count[$key]}"
-        done
-        output_text+="\n  },\n"
-        output_text+="  \"skills\": [\n"
-        first=true
-        for line in "${skills_data[@]}"; do
-            IFS='|' read -r name l sl s v r sl_l rc rl d <<< "$line"
-            if [ "$first" = true ]; then first=false; else output_text+=",\n"; fi
-            d_escaped=$(echo "$d" | sed 's/"/\\"/g')
-            output_text+="    {\"name\":\"$name\",\"layer\":\"$l\",\"subLayer\":\"$sl\",\"stack\":\"$s\",\"version\":\"$v\",\"risk\":\"$r\",\"skillLines\":$sl_l,\"refCount\":$rc,\"refLines\":$rl,\"description\":\"$d_escaped\"}"
-        done
-        output_text+="\n  ]\n"
-        output_text+="}\n"
-        ;;
-    markdown)
-        output_text+="# Skill 清单盘点\n\n"
-        output_text+="**生成时间**：$NOW\n\n"
-        output_text+="**总数**：$total_count 个 skill\n\n"
-        output_text+="**总 references 行数**：$total_ref_lines\n\n"
-        output_text+="## Layer 分布\n\n"
-        output_text+="| Layer | 数量 |\n|-------|------|\n"
-        for key in $(echo "${!layer_count[@]}" | tr ' ' '\n' | sort); do
-            output_text+="| $key | ${layer_count[$key]} |\n"
-        done
-        output_text+="\n## Sub-Layer 分布\n\n"
-        output_text+="| Sub-Layer | 数量 |\n|-----------|------|\n"
-        for key in $(echo "${!sub_layer_count[@]}" | tr ' ' '\n' | sort); do
-            output_text+="| $key | ${sub_layer_count[$key]} |\n"
-        done
-        output_text+="\n## Skill 列表\n\n"
-        output_text+="| Name | Layer | Sub-Layer | Stack | Ver | Risk | SKILL 行 | Refs | Ref 行 |\n"
-        output_text+="|------|-------|-----------|-------|-----|------|----------|------|--------|\n"
-        for line in "${skills_data[@]}"; do
-            IFS='|' read -r name l sl s v r sl_l rc rl _ <<< "$line"
-            output_text+="| $name | $l | $sl | $s | $v | $r | $sl_l | $rc | $rl |\n"
-        done
-        ;;
-    *)
-        # console
-        echo "========================================"
-        echo "  skill-stocktake: skill 清单盘点"
-        echo "========================================"
-        echo "生成时间: $NOW"
-        echo "总数: $total_count 个 skill"
-        echo "References 总行数: $total_ref_lines"
-        echo ""
-        echo "Layer 分布:"
-        for key in $(echo "${!layer_count[@]}" | tr ' ' '\n' | sort); do
-            printf "  %-8s %d\n" "$key" "${layer_count[$key]}"
-        done
-        echo ""
-        echo "Sub-Layer 分布:"
-        for key in $(echo "${!sub_layer_count[@]}" | tr ' ' '\n' | sort); do
-            printf "  %-8s %d\n" "$key" "${sub_layer_count[$key]}"
-        done
-        echo ""
-        echo "Skill 列表:"
-        printf "  %-45s %-5s %-7s %-12s %s\n" "Name" "Layer" "Sub" "Stack" "Ver"
-        echo "  ---------------------------------------------------------------------------------"
-        for line in "${skills_data[@]}"; do
-            IFS='|' read -r name l sl s v _ _ _ _ _ <<< "$line"
-            printf "  %-45s %-5s %-7s %-12s %s\n" "$name" "$l" "$sl" "$s" "$v"
-        done
-        echo ""
-        ;;
-esac
-if [ -n "$OUTPUT" ]; then
-    echo -e "$output_text" > "$OUTPUT"
-    echo "已写入: $OUTPUT"
-else
-    echo -e "$output_text"
-fi