# content-calendar-skill

> 🌐 项目主页：https://tggai.cn/skill/

让 Claude Code(或任何 agent)通过 CLI 管理团队内容选题日历的技能包。TggAI Skills 平台的第一个技能，遵循 [Agent Skills 开放标准](https://agentskills.io)。

日历本体是一个轻量网页应用(GUI + 服务器端 data.json + 保存 API),团队成员可以用网页点点点,
也可以让自己的 agent 用 `topic` 命令增删改查——两边写的是同一份数据。

```
会 CLI 的人 / agent ──topic 命令(HTTPS)──┐
                                         ├──> 服务器 data.json <──读── 所有人的浏览器
不会 CLI 的伙伴 ──网页点保存──> 保存 API ──┘
```

## 安装(使用者)

需要向日历管理员索取两样东西:**日历地址** 和 **访问账号:密码**。本仓库不含任何真实地址或凭据。

```bash
CALENDAR_URL="https://你的域名/日历路径" CALENDAR_AUTH="账号:密码" bash install.sh
```

或交互式: `bash install.sh` 按提示填。安装内容:

| 文件 | 作用 |
|---|---|
| `~/.local/bin/topic` | CLI 客户端(python3 标准库,零依赖) |
| `~/.claude/skills/content-calendar/SKILL.md` | Claude Code 技能,自然语言触发 |
| `~/.calendar-url` / `~/.calendar-auth` | 地址与凭据(600 权限) |

装完后在 Claude Code 里直接说"选题日历加一条xxx"即可;或手动使用:

```bash
topic list
topic add --title "新选题" --platform 小红书 --date 2026-07-20
topic edit 关键词 --stage 发布
```

## 仓库内容

- `SKILL.md` — Claude Code 技能定义(字段对照、工作流程)
- `topic-remote` — CLI 客户端源码
- `install.sh` — 一键安装脚本

## 服务器端(管理员)

服务器端需要:静态站点目录(index.html/app.js/styles.css/data.json) + 一个把 POST 写入
data.json 的小 API(本仓库不含,几十行 python 即可) + 反向代理和 Basic Auth。
凭据即网页的 Basic Auth,改密码 = 收回所有 CLI/agent 访问权。