Files

John Qiu dcdae8c636 chore(marketplace): add publish-plugin, rewrite init.sh, cleanup obsolete plugins

- Add publish-plugin: marketplace publish + Feishu bot notification
- Rewrite init.sh: SSE-first, fixed prod API, remove env selection
- Update CLAUDE.md, README.md, claude-config.yaml
- Update skills: req-plugin, req-prd-plugin, pull-request-plugin
- Delete sync-skills.sh (obsolete)
- Delete deprecated plugins: skills-ops/*, skills-projects/*, old skills-dev/req duplicates
- Regenerate marketplace.json (27 plugins)

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

2026-03-14 15:09:07 +10:30

4.5 KiB

Raw Permalink Blame History

name, description, user_invocable

name	description	user_invocable
publish	发布 ai-proj-helper 技能市场更新并通知飞书群。用户说 /publish 时激活。	true

publish - 技能市场发布与通知

发布 ai-proj-helper 的技能变更，重新生成 marketplace.json，提交推送到 Gitea，并通过飞书 Webhook 通知团队。

命令

/publish [消息] — 发布当前变更并通知飞书

流程

1. 检查工作目录状态 (git status)
2. 运行 generate-marketplace.py 重新生成 marketplace.json
3. 生成变更摘要（新增/更新/删除了哪些技能）
4. git add + commit + push
5. 发送飞书卡片通知

详细步骤

Step 1: 检查工作目录

cd <ai-proj-helper-root>
git status

确认当前在正确的仓库中。如果没有任何变更（包括 marketplace.json），提示用户无需发布。

Step 2: 重新生成 marketplace.json

cd <ai-proj-helper-root>
python3 generate-marketplace.py

输出会显示扫描到的各分类技能数量。

Step 3: 生成变更摘要

对比 git diff 结果，提取变更内容：

新增技能：新出现的 *-plugin/ 目录
更新技能：已有技能的 SKILL.md 或 plugin.json 变更
删除技能：被移除的 *-plugin/ 目录
配置变更：claude-config.yaml、init.sh 等基础文件变更

摘要格式：

新增: feishu-bitable-plugin, doubao-voice-plugin
更新: req-plugin (SKILL.md)
删除: old-plugin
配置: init.sh 默认改为 SSE 模式

Step 4: Git 提交并推送

cd <ai-proj-helper-root>
git add -A
git commit -m "chore(marketplace): <变更摘要>"
git push origin main

Commit message 示例：

chore(marketplace): add feishu-bitable-plugin, update req-plugin
chore(marketplace): update init.sh to SSE default

Step 5: 飞书通知

Webhook 地址：从环境变量 FEISHU_DEPLOY_WEBHOOK 读取，配置在 ~/.config/devops/credentials.env。

如果环境变量未设置，AskUserQuestion 询问用户提供 webhook URL，并建议添加到 credentials.env。

卡片格式（必须用 legacy format，不用 schema 2.0）：

# 先 source 凭据
source ~/.config/devops/credentials.env

# 构建卡片 JSON（必须写文件，不能直接传中文 JSON）
cat > /tmp/publish_notify.json << 'CARD_EOF'
{
  "msg_type": "interactive",
  "card": {
    "header": {
      "title": {"tag": "plain_text", "content": "AI 技能市场更新"},
      "template": "green"
    },
    "elements": [
      {
        "tag": "div",
        "text": {"tag": "lark_md", "content": "CHANGE_SUMMARY_HERE"}
      },
      {
        "tag": "div",
        "text": {"tag": "lark_md", "content": "**提交**: COMMIT_HASH_HERE"}
      },
      {
        "tag": "action",
        "actions": [{
          "tag": "button",
          "text": {"tag": "plain_text", "content": "查看仓库"},
          "type": "primary",
          "url": "https://gitea.pipexerp.com/pipexerp/ai-proj-helper"
        }]
      }
    ]
  }
}
CARD_EOF

# 替换占位符后发送
curl -s -X POST "$FEISHU_DEPLOY_WEBHOOK" \
  -H "Content-Type: application/json" \
  -d @/tmp/publish_notify.json

重要：

必须用 legacy card format（无 schema 字段），否则返回 ErrCode 11246
中文内容必须先写文件再 curl -d @file，直接传会出现 "blank argument" 错误
template 颜色：green=成功，red=失败，blue=信息

自定义消息

用户可以在 /publish 后附加自定义消息，会追加到卡片内容中：

/publish 新增飞书多维表格技能，支持批量数据导入

卡片内容将包含：

**更新说明**: 新增飞书多维表格技能，支持批量数据导入

**变更**: 新增 feishu-bitable-plugin
**提交**: abc1234

环境配置

在 ~/.config/devops/credentials.env 中添加：

# 飞书部署通知 Webhook
FEISHU_DEPLOY_WEBHOOK="https://open.feishu.cn/open-apis/bot/v2/hook/YOUR_WEBHOOK_KEY"

错误处理

场景	处理
无变更可提交	提示用户，跳过后续步骤
generate-marketplace.py 失败	显示错误，中止发布
git push 失败	显示错误，建议手动解决冲突
FEISHU_DEPLOY_WEBHOOK 未配置	AskUserQuestion 询问 webhook URL
飞书通知发送失败	显示 curl 返回值，提示但不阻断（代码已推送成功）

注意事项

此技能操作的仓库路径由 marketplace 插件根目录决定
发布前确认 generate-marketplace.py 输出无异常
飞书通知是 best-effort，失败不影响代码发布

4.5 KiB Raw Permalink Blame History Unescape Escape