Skip to content
Back to search

jikeyan

MarketplaceWorks with Claude CodeGitHub

Official 极科研 (jikeyan) skills: research project management for AI agents

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/871922384--jikeyan-agent-skill/badge.svg)](/listings/871922384--jikeyan-agent-skill)

HTML

<a href="/listings/871922384--jikeyan-agent-skill"><img src="/api/listings/871922384--jikeyan-agent-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**1. Generate a key** — in the 极科研 app: **设置 → 连接智能体** (Settings → Connect Agent).

**2. Export it** — the key lives only in your environment, never in a repo:

export JIKEYAN_AGENT_KEY='<your agent key>'

**3. Install the skill or the MCP server** — pick one row, details in `<details>` below:

| Client | Skill | MCP server | |---|---|---| | Claude Code | `/plugin marketplace add 871922384/jikeyan-agent-skill` then `/plugin install jikeyan@jikeyan` | `.mcp.json` snippet | | Codex | copy `plugins/jikeyan/skills/*` to `~/.codex/skills/` | `codex mcp add …` snippet | | Cursor / Windsurf / other MCP clients | copy `plugins/jikeyan/skills/*` to the client's skills dir | generic stdio config |

Then ask your agent to "use the jikeyan skill and run `get_schema` first".

<details> <summary><strong>Claude Code</strong></summary>

Skill (recommended):

/plugin marketplace add 871922384/jikeyan-agent-skill
/plugin install jikeyan@jikeyan

Portable fallback: copy `plugins/jikeyan/skills/*` to `~/.claude/skills/`.

MCP server (`.mcp.json`, project-level — keep uncommitted if it holds your key; no PyPI needed, pick the uvx line or the docker line):

{
  "mcpServers": {
    "jikeyan": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/871922384/jikeyan-agent-skill#subdirectory=mcp",
        "jikeyan-mcp"
      ],
      "env": {
        "JIKEYAN_AGENT_KEY": "${JIKEYAN_AGENT_KEY}",
        "JIKEYAN_API_BASE_URL": "https://api.jikeyan.cn"
      }
    }
  }
}

Docker alternative (no local Python needed; pin a version tag from `server.json`, `latest` also works):

{
  "mcpServers": {
    "jikeyan": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "JIKEYAN_AGENT_KEY",
        "-e",
        "JIKEYAN_API_BASE_URL=https://api.jikeyan.cn",
        "ghcr.io/871922384/jikeyan-mcp:latest"
      ]
    }
  }
}

</details>

<details> <summary><strong>Codex</strong></summary>

Skill: copy `plugins/jikeyan/skills/*` to `~/.codex/skills/`.

MCP server (no PyPI needed):

codex mcp add jikeyan \
  --env JIKEYAN_AGENT_KEY="$JIKEYAN_AGENT_KEY" \
  --env JIKEYAN_API_BASE_URL=https://api.jikeyan.cn \
  -- uvx --from "git+https://github.com/871922384/jikeyan-agent-skill#subdirectory=mcp" jikeyan-mcp

Docker alternative:

codex mcp add jikeyan \
  -- docker run -i --rm -e JIKEYAN_AGENT_KEY -e JIKEYAN_API_BASE_URL=https://api.jikeyan.cn ghcr.io/871922384/jikeyan-mcp:latest

</details>

<details> <summary><strong>Cursor / Windsurf / Gemini CLI / other MCP clients</strong></summary>

Add a stdio server with environment variables `JIKEYAN_AGENT_KEY` + `JIKEYAN_API_BASE_URL=https://api.jikeyan.cn`. No PyPI needed — pick one launch command:

uvx --from "git+https://github.com/871922384/jikeyan-agent-skill#subdirectory=mcp" jikeyan-mcp
docker run -i --rm -e JIKEYAN_AGENT_KEY ghcr.io/871922384/jikeyan-mcp:latest

Plain-HTTP alternative (no MCP): `plugins/jikeyan/skills/jikeyan-agent/scripts/jikeyan.sh` is a curl wrapper around the same API — `JIKEYAN_AGENT_KEY` + `get/post/patch`.

</details>

<details> <summary><strong>China: domestic agents & mirrors (国内平台)</strong></summary>

Full copy-paste configs live in [README.zh-CN.md](README.zh-CN.md#在国内-agent-中使用) — CodeBuddy & WorkBuddy (腾讯), Qwen Code CLI, 通义灵码/Qoder, 百炼智能体应用, Trae, 扣子 Coze, ModelScope MCP 广场, Kimi & 智谱托管智能体(远程 MCP)。

Mainland mirrors (only needed after the PyPI release; the API itself needs no proxy). Until then use the git `uvx --from …` or the GHCR docker image above:

# uv / pip via Tsinghua or Aliyun mirror
export UV_INDEX_URL='https://pypi.tuna.tsinghua.edu.cn/simple'
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple jikeyan-mcp
# or: https://mirrors.aliyun.com/pypi/simple/

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines
  1. {
  2. "name": "jikeyan",
  3. "description": "Official 极科研 (jikeyan) skills: research project management for AI agents",
  4. "owner": {
  5. "name": "jikeyan",
  6. "url": "https://jikeyan.cn"
  7. },
  8. "plugins": [
  9. {
  10. "name": "jikeyan",
  11. "source": "./plugins/jikeyan",
  12. "description": "Research project management skills + MCP server (daily review, waiting items, submissions, review rounds)"
  13. }
  14. ]
  15. }
README.md · README · 261 lines
  1. <p align="center">
  2. <img src="assets/logo.png" width="128" alt="极科研 app icon" />
  3. </p>
  4. <h1 align="center">jikeyan-agent-skill</h1>
  5. <p align="center">
  6. Give your AI agent a research dashboard: projects, deadlines, waiting items, submissions, reviews.
  7. <br />
  8. 让 AI 智能体替你管项目、盯截止、跟等待项——科研项目管理,一句话直达。
  9. <br />
  10. <a href="https://jikeyan.cn">Website</a> ·
  11. <a href="https://apps.apple.com/app/id6785017540">App Store</a> ·
  12. <a href="https://api.jikeyan.cn/agent.md">Agent guide</a> ·
  13. <a href="README.zh-CN.md">中文</a>
  14. </p>
  15. <p align="center">
  16. <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" /></a>
  17. <a href="mcp/README.md"><img src="https://img.shields.io/badge/MCP-stdio-blue" alt="MCP: stdio" /></a>
  18. <a href="plugins/jikeyan/skills/jikeyan-agent/SKILL.md"><img src="https://img.shields.io/badge/Claude_Code-skill-purple" alt="Claude Code skill" /></a>
  19. <a href="plugins/jikeyan/skills/jikeyan-agent/SKILL.md"><img src="https://img.shields.io/badge/Codex-skill-teal" alt="Codex skill" /></a>
  20. </p>
  21. > Official agent skills + MCP server for [极科研 (jikeyan)](https://jikeyan.cn), a local-first iOS
  22. > kanban app for research project management. Two installable skills and a standalone MCP server,
  23. > all speaking to the same documented Agent API ([online guide](https://api.jikeyan.cn/agent.md)).
  24. > **中文说明见 [README.zh-CN.md](README.zh-CN.md)**(含国内 agent 平台配置:CodeBuddy、Qwen Code、通义灵码、百炼、Trae、Coze 等)。
  25. ## How it works
  26. ```mermaid
  27. flowchart LR
  28. A["Your agent\n(skill / MCP)"] <--> B["Agent API\napi.jikeyan.cn"]
  29. B <--> C["📱 极科研 App\n(your data, local-first)"]
  30. style B fill:#e8f4f8,stroke:#57c4d9
  31. ```
  32. Your data stays on your device and the 极科研 backend in China (`api.jikeyan.cn`, no proxy needed).
  33. The agent only sees what your Agent Key permits (read-only or project-scoped), and drafts — never sends —
  34. follow-ups on your behalf.
  35. ## Screenshots
  36. <p align="center">
  37. <img src="assets/screenshots/today.png" width="220" alt="Today view: overdue items, today's tasks, and waiting items to chase" />
  38. <img src="assets/screenshots/project.png" width="220" alt="Project view: nodes, waiting items, timeline" />
  39. <img src="assets/screenshots/connect-agent.png" width="220" alt="Connect Agent screen in Settings: key status, setup steps, key management" />
  40. <br />
  41. <em>Today · Project · Connect agent — all shots use built-in demo data, no real projects.</em>
  42. </p>
  43. ## What your agent can do
  44. | Ask your agent to… | What happens under the hood |
  45. |---|---|
  46. | ☀️ Brief me this morning | Overdue nodes, items due in 7 days, waiting items to re-check today, last 48h of updates (`get_today` + daily-review workflow) |
  47. | ⏳ Chase what's stuck | Find stalled "waiting on someone" items and draft bilingual follow-up messages (you send them; the agent never contacts anyone) |
  48. | 📦 Import my projects | Create projects idempotently via your own `external_ref`, then add nodes in one versioned patch |
  49. | 📝 Split reviewer comments | Break review comments into numbered actions, draft a point-by-point response letter, record the round (`add_review_round`) |
  50. | ✅ Pre-submission check | Journal requirements, ethics, authorship, references, figures, cover letter — one item at a time |
  51. | 📅 Count down to a deadline | Plan backwards from a hard date with buffers for external feedback and co-author confirmation |
  52. | 🔍 Verify references & screen topics | Check BibTeX metadata against Crossref/PubMed; screen ClinicalTrials.gov + PubMed reviews (runs locally, never touches the jikeyan server) |
  53. | 🔄 Weekly review | What got done, what's due next, what's stalled, what needs your decision |
  54. ### What the first conversation looks like
  55. The agent greets you with a live summary of your board (demo data below — not real projects),
  56. then waits for your pick. No endpoints, no keys, just the work:
  57. > **Agent:** Hi! I've taken over your Jikeyan project board, and every change will show
  58. > up on your phone. You have 3 active projects, 1 of them overdue and worth tackling
  59. > first, plus 2 waiting items due for a follow-up today. Where should we start?
  60. > I can update stages and deadlines, chase ethics approvals and collaborator replies,
  61. > log submissions and review rounds — for example:
  62. > ① add your breast-cancer prognosis study (first draft due next Friday),
  63. > ② check what's waiting on replies today, ③ log the major-revision round that just came back.
  64. >
  65. > **You:** Let's do ② — what's waiting on replies today?
  66. >
  67. > **Agent:** Two things: the ethics approval has been with the committee for 12 days
  68. > (I drafted a polite chase note — say the word and I'll finalize the wording for you
  69. > to send), and Dr. Li's pathology feedback was due yesterday. Want me to set both
  70. > to re-check tomorrow morning?
  71. >
  72. > **You:** Yes, and log the major revision as round two while you're at it.
  73. >
  74. > **Agent:** Done — both waiting items will resurface in tomorrow's brief, and round two
  75. > is logged with a response deadline 4 weeks out. Anything else to push forward today?
  76. ## Quickstart
  77. **1. Generate a key** — in the 极科研 app: **设置 → 连接智能体** (Settings → Connect Agent).
  78. **2. Export it** — the key lives only in your environment, never in a repo:
  79. ```bash
  80. export JIKEYAN_AGENT_KEY='<your agent key>'
  81. ```
  82. **3. Install the skill or the MCP server** — pick one row, details in `<details>` below:
  83. | Client | Skill | MCP server |
  84. |---|---|---|
  85. | Claude Code | `/plugin marketplace add 871922384/jikeyan-agent-skill` then `/plugin install jikeyan@jikeyan` | `.mcp.json` snippet |
  86. | Codex | copy `plugins/jikeyan/skills/*` to `~/.codex/skills/` | `codex mcp add …` snippet |
  87. | Cursor / Windsurf / other MCP clients | copy `plugins/jikeyan/skills/*` to the client's skills dir | generic stdio config |
  88. Then ask your agent to "use the jikeyan skill and run `get_schema` first".
  89. <details>
  90. <summary><strong>Claude Code</strong></summary>
  91. Skill (recommended):
  92. ```bash
  93. /plugin marketplace add 871922384/jikeyan-agent-skill
  94. /plugin install jikeyan@jikeyan
  95. ```
  96. Portable fallback: copy `plugins/jikeyan/skills/*` to `~/.claude/skills/`.
  97. MCP server (`.mcp.json`, project-level — keep uncommitted if it holds your key;
  98. no PyPI needed, pick the uvx line or the docker line):
  99. ```json
  100. {
  101. "mcpServers": {
  102. "jikeyan": {
  103. "command": "uvx",
  104. "args": [
  105. "--from",
  106. "git+https://github.com/871922384/jikeyan-agent-skill#subdirectory=mcp",
  107. "jikeyan-mcp"
  108. ],
  109. "env": {
  110. "JIKEYAN_AGENT_KEY": "${JIKEYAN_AGENT_KEY}",
  111. "JIKEYAN_API_BASE_URL": "https://api.jikeyan.cn"
  112. }
  113. }
  114. }
  115. }
  116. ```
  117. Docker alternative (no local Python needed; pin a version tag from
  118. `server.json`, `latest` also works):
  119. ```json
  120. {
  121. "mcpServers": {
  122. "jikeyan": {
  123. "command": "docker",
  124. "args": [
  125. "run",
  126. "-i",
  127. "--rm",
  128. "-e",
  129. "JIKEYAN_AGENT_KEY",
  130. "-e",
  131. "JIKEYAN_API_BASE_URL=https://api.jikeyan.cn",
  132. "ghcr.io/871922384/jikeyan-mcp:latest"
  133. ]
  134. }
  135. }
  136. }
  137. ```
  138. </details>
  139. <details>
  140. <summary><strong>Codex</strong></summary>
  141. Skill: copy `plugins/jikeyan/skills/*` to `~/.codex/skills/`.
  142. MCP server (no PyPI needed):
  143. ```bash
  144. codex mcp add jikeyan \
  145. --env JIKEYAN_AGENT_KEY="$JIKEYAN_AGENT_KEY" \
  146. --env JIKEYAN_API_BASE_URL=https://api.jikeyan.cn \
  147. -- uvx --from "git+https://github.com/871922384/jikeyan-agent-skill#subdirectory=mcp" jikeyan-mcp
  148. ```
  149. Docker alternative:
  150. ```bash
  151. codex mcp add jikeyan \
  152. -- docker run -i --rm -e JIKEYAN_AGENT_KEY -e JIKEYAN_API_BASE_URL=https://api.jikeyan.cn ghcr.io/871922384/jikeyan-mcp:latest
  153. ```
  154. </details>
  155. <details>
  156. <summary><strong>Cursor / Windsurf / Gemini CLI / other MCP clients</strong></summary>
  157. Add a stdio server with environment variables
  158. `JIKEYAN_AGENT_KEY` + `JIKEYAN_API_BASE_URL=https://api.jikeyan.cn`.
  159. No PyPI needed — pick one launch command:
  160. ```bash
  161. uvx --from "git+https://github.com/871922384/jikeyan-agent-skill#subdirectory=mcp" jikeyan-mcp
  162. ```
  163. ```bash
  164. docker run -i --rm -e JIKEYAN_AGENT_KEY ghcr.io/871922384/jikeyan-mcp:latest
  165. ```
  166. Plain-HTTP alternative (no MCP): `plugins/jikeyan/skills/jikeyan-agent/scripts/jikeyan.sh`
  167. is a curl wrapper around the same API — `JIKEYAN_AGENT_KEY` + `get/post/patch`.
  168. </details>
  169. <details>
  170. <summary><strong>China: domestic agents & mirrors (国内平台)</strong></summary>
  171. Full copy-paste configs live in [README.zh-CN.md](README.zh-CN.md#在国内-agent-中使用) —
  172. CodeBuddy & WorkBuddy (腾讯), Qwen Code CLI, 通义灵码/Qoder, 百炼智能体应用, Trae, 扣子 Coze,
  173. ModelScope MCP 广场, Kimi & 智谱托管智能体(远程 MCP)。
  174. Mainland mirrors (only needed after the PyPI release; the API itself needs no proxy).
  175. Until then use the git `uvx --from …` or the GHCR docker image above:
  176. ```bash
  177. # uv / pip via Tsinghua or Aliyun mirror
  178. export UV_INDEX_URL='https://pypi.tuna.tsinghua.edu.cn/simple'
  179. pip install -i https://pypi.tuna.tsinghua.edu.cn/simple jikeyan-mcp
  180. # or: https://mirrors.aliyun.com/pypi/simple/
  181. ```
  182. </details>
  183. ## Contents
  184. | Path | What it is |
  185. |---|---|
  186. | `plugins/jikeyan/skills/jikeyan-agent/` | Skill: Agent API cookbook + `jikeyan.sh` curl wrapper + endpoint table |
  187. | `plugins/jikeyan/skills/jikeyan-academic-colleague/` | Skill: research-management workflows (daily/weekly review, stalled detection, waiting-item follow-up, review response, pre-submission, backward planning) |
  188. | `mcp/` | Standalone Python package `jikeyan-mcp` (17 MCP tools, stdio). See [mcp/README.md](mcp/README.md) |
  189. | `assets/` | Logo, App screenshots (demo data only), social preview image |
  190. | `.claude-plugin/marketplace.json` | Claude Code plugin marketplace manifest |
  191. | `server.json` | Official MCP Registry manifest (prepared, not yet submitted) |
  192. | `smithery.yaml` | Smithery deploy config (prepared, not yet submitted) |
  193. | `llms.txt` | LLM-readable repo summary |
  194. | `docs/distribution.md` | Format sources, repo metadata, manual submission checklist, China listing tracker |
  195. ## Security & privacy
  196. - The Agent Key is read from the environment (`JIKEYAN_AGENT_KEY`) only. Never hard-code it, never commit it, never paste it into chat logs.
  197. - **Never send patient names, hospital IDs, diagnoses, or follow-up text.** The API has no fields for them and rejects unknown fields — keep it that way. Personal notes stay on your device and are never synced.
  198. - The MCP server runs on your own machine; it logs only tool names and HTTP status codes — no keys, no content.
  199. - Key permissions (read-only, project-scoped) are enforced server-side. A revoked key returns `401`: regenerate it in the app.
  200. ## Links
  201. - 极科研: [https://jikeyan.cn](https://jikeyan.cn) · [App Store](https://apps.apple.com/app/id6785017540) · [Privacy](https://jikeyan.cn/privacy)
  202. - Agent API online guide: [https://api.jikeyan.cn/agent.md](https://api.jikeyan.cn/agent.md)
  203. - MCP package: [mcp/README.md](mcp/README.md)
  204. ## License
  205. MIT, see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.