Jinka

把一个 Markdown 愿望文件交给 Claude Code,由命令行让 GitHub 仓库按你的想法变好。

Star 数
★ 20
最近更新
3 天前
License
MIT
主语言
JavaScript

30 秒速览

运行形态
命令行工具
可在哪里用
平台专用Claude Code
费用
软件免费,模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
Node.js(npm 全局安装)Claude CodeShell / 命令行网络访问本地文件系统
典型场景
已经使用 Claude Code,希望把重复性的仓库维护任务写成可复用 Markdown 指令的开发者。
不适合
  • 不希望依赖 Claude Code 的团队
  • 需要图形界面或浏览器操作的用户
  • 要求模型供应商可自由切换的组织
维护状态
近 30 天有提交最近提交 2026-11-18最新版本 0.0.14(2026-11-17)

这个 Agent 能做什么,适合哪些场景?

Jinka 是一个基于 Node.js 的命令行编排器,通过 npm 全局包 @yegor256/jinka 分发,采用 MIT 许可证。它的工作方式很直接:用户在 ~/.jinka/wishes/ 目录下放置 Markdown 愿望文件(如 Make-Me-Happy.md),文件里用自然语言描述目标,例如希望某个 GitHub 仓库保持良好状态。安装并直接运行 jinka 命令后,它会读取这些愿望,并借助 Claude Code 去执行。项目自身在 README 中定位为“简单的 Agent 命令行编排器”,代码仓库主题包括 coding-agent、harness、llm-agents 等。它不提供托管服务或图形界面,运行边界就是本地终端加本地文件系统。

Jinka 读取 ~/.jinka/wishes/ 下的 Markdown 文件作为输入,每个文件用自然语言写下一个愿望,README 示例为“I wish my GitHub repository to be in good shape: foo/bar.”。用户执行 jinka 命令后,工具解析这些愿望并借助 Claude Code 去完成对应工作,例如检查或整理指定的 GitHub 仓库。整个流程是:写愿望文件 → 全局安装 → 运行 jinka → 等待结果。README 未说明输出格式、日志位置或失败重试机制。

  1. 已经使用 Claude Code,希望把重复性的仓库维护任务写成可复用 Markdown 指令的开发者。
  2. 想在终端里用一句自然语言描述来触发 GitHub 仓库检查或整理的维护者。
  3. 偏好文件即配置、不愿学习复杂 CLI 参数的个人开发者。
  4. 需要把多个日常开发愿望集中存放在 ~/.jinka/wishes/ 下批量执行的工程师。
  5. 评估轻量级 Agent 编排器以替代手写脚本的团队。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • npm install -g @yegor256/jinka
配置文件
~/.jinka/wishes/Make-Me-Happy.md

如何安装或部署这个 Agent?

需要 Node.js 与 npm 环境,并已具备 Claude Code。

npm install -g @yegor256/jinka

安装后即可在终端使用 jinka 命令。

如何使用这个 Agent?

第一步,创建愿望文件:

~/.jinka/wishes/Make-Me-Happy.md

文件内容示例:

I wish my GitHub repository to be in good shape: `foo/bar`.

第二步,直接运行:

jinka

README 未说明是否会提示选择愿望、是否一次性执行所有文件,也未给出额外参数。

这个 Agent 有哪些优点和局限?

优点
  • 愿望即文件:用 Markdown 描述目标,无需记忆复杂命令行参数。
  • 安装路径极短:一条 npm 全局安装命令即可开始使用。
  • 与 Claude Code 集成,复用已有的编码代理能力而非自建 LLM 调用层。
  • MIT 许可证,可自由修改与再分发。
局限
  • 核心能力依赖 Claude Code,README 未提供其他模型或供应商适配路径。
  • README 极简,缺少输出格式、错误处理、日志与并发行为说明。
  • 没有图形界面或托管服务,只能在本地终端使用。
  • 仅有单个示例愿望,缺少任务覆盖面与最佳实践的文档。

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Jinka 当前 41 · 缺口较多 命令行工具免费 + 模型费 ★ 20 3 天前 JavaScript Claude Code
Ordewell 87 · 表现良好 命令行工具免费 + 模型费 ★ 211 今天 TypeScript Codex · Claude Code · OpenAI API · Claude API
Cersei — Rust 编程智能体 SDK 56 · 缺口较多 代码库 / SDK免费 + 模型费 ★ 467 3 个月前 Rust OpenAI API · Claude API
Nori Skillsets 45 · 缺口较多 命令行工具免费 ★ 170 1 天前 TypeScript Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
41/ 100 五分制 2.1 / 5
信任安全 10/29
可靠稳定 6/14
适用触发 10/18
规范维护 6/18
有效结果 6/13
证据核验 3/8
查看各维度的扣分理由
信任安全10 / 29 · 1.7/5

技能文件对合并、发 issue、写 wish 等外部副作用设定了明确的前置门禁(审批评审、检查通过、无冲突),并禁止子代理与越权操作,这是 least_privilege 与 external_effects 的正面证据;但合并 PR、自动发 issue 属于不可撤销的外部动作,未见任何人工确认环节,user_confirmation 仅得 1。数据流方面,README 与 CLAUDE.md 均未说明 wish 内容、代码、日志被发送给哪个模型或服务,data_flow_transparency 与 sensitive_data_handling 仅凭技能中“把 PR/日志当作数据”的提示得 1。依赖仅列出 commander、cross-spawn、slice-ansi,无锁文件、无审计或版本固定说明,dependency_security 得 1。回滚方面只有归档目录与 triaged.csv 追加记录,未见对已合并 PR 或已发 issue 的撤销机制,rollback 得 1。来源归属有 LICENSE 与 SPDX 头,但发布者身份未经验证,source_attribution 得 1。

可靠稳定6 / 14 · 2.1/5

技能文本内部一致:各技能都声明“不构建、不测试、不派发子代理”,与 CLAUDE.md 的 README 约束不冲突,self_consistency 得 2。依赖可用性方面 engines 要求 Node>=20.12,依赖用 ^ 浮动范围且无 lockfile,dependency_availability 得 1。失败信息方面测试断言带有可读消息,但产品运行时对用户可见的错误提示在样本中不可见,failure_messages 得 1。

适用触发10 / 18 · 2.8/5

技能描述给出了清晰的触发短语(“merge PR”“check CI”“find a new bug”等)与停止条件,trigger_precision 与 capability_boundaries 各得 2;audience_and_scenarios 覆盖仓库维护、CI 巡检、积压清理等场景,得 2。环境适配仅提及 GitHub 与 gh CLI、Node 版本,未见对非 GitHub 平台或权限缺失环境的说明,environment_fit 得 1。

规范维护6 / 18 · 1.7/5

README 极短且 CLAUDE.md 明确要求不写用法细节,导致信息架构单薄,information_architecture 得 1;安装步骤(npm install -g)清晰,install_notes 得 2。命名稳定性方面版本号为 0.0.0,naming_stability 得 1。示例仅有一个 wish 示例,无 FAQ,examples_and_faq 得 1。未见已知限制章节,known_limitations 得 0。LICENSE 完整为 MIT,license 得 2。无 CHANGELOG,versioning_changelog 得 0。维护责任仅由 package.json 的 author 字段体现,发布者未经验证,maintenance_responsibility 得 1。

有效结果6 / 13 · 2.3/5

技能输出规范(标题格式、片段引用、简洁措辞)使产出可直接用于 GitHub,output_usability 得 2。但产品价值依赖外部 Claude Code 与 gh 凭据,且自动合并/发 issue 的边际价值在缺少评测证据下只能算中等,marginal_value 得 1;成本方面每次运行需调用模型并访问 GitHub API,未见成本控制说明,cost_benefit 得 1。

证据核验3 / 8 · 1.9/5

技能中的门禁条件(审批评审、检查状态)可追溯到 GitHub API 查询,claim_traceability 得 1;测试文件与源码模块(agent、appended、archived)相互印证,cross_source_corroboration 得 1;但 README 的“愿望成真”承诺与技能实际能力之间缺少明确的事实/推断分离说明,fact_inference_separation 得 1。

风险与缓解建议
  • 技能会在无人工确认的情况下自动合并 PR 和创建 issue,属于不可撤销的外部副作用,建议在启用前限制仓库范围并审查门禁条件。
  • README 与 CLAUDE.md 均未说明 wish 内容、代码与日志被发送给哪个模型或服务,存在数据流不透明风险。
  • 依赖使用浮动版本且无 lockfile,安装结果可能随时间变化。
  • 版本号为 0.0.0,接口与行为可能不稳定;发布者身份未经验证。
证据充分度:低 评估于 2026年11月18日 审查版本 ce0fb2f235d2
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/jinka.svg?lang=zh)](https://followagents.com/zh/agents/jinka)
<a href="https://followagents.com/zh/agents/jinka"><img src="https://followagents.com/badge/jinka.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 0.0.14
    发布说明摘录
    What's Changed * Show the summary of a JSON answer in the thread row by @yegor256 in https://github.com/yegor256/jinka/pull/227 * chore(deps): update reviewdog/action-actionlint action to v1.84.1 by @renovate[bot] in https://github.com/yegor256/jinka/pull/229 * chore(deps): update dependency eslint to v10.15.0 by @renovate[bot] in https://github.com/yegor256/jinka/pull/230 * chore(deps): update crate-ci/typos action to v1.52.2 by @renovate[bot] in https://github.com/yegor256/jinka/pull/228 …
    在 GitHub 查看 ↗
  2. 0.0.13
    发布说明摘录
    What's Changed * chore(deps): update dependency slice-ansi to v10.0.1 by @renovate[bot] in https://github.com/yegor256/jinka/pull/219 * Paint the token count red when it is over one million by @yegor256 in https://github.com/yegor256/jinka/pull/222 * Run every wish in its own temporary directory under ~/.jinka by @yegor256 in https://github.com/yegor256/jinka/pull/223 * Repair red or conflicting pull requests opened by this account by @yegor256 in https://github.com/yegor256/jinka/pull/225 Full Changelog: https://github.com/yegor256/jinka/compare/0.0.12...0.0.13
    在 GitHub 查看 ↗
  3. 0.0.12
    发布说明摘录
    What's Changed * Forbid the agent to schedule work for later by @yegor256 in https://github.com/yegor256/jinka/pull/180 * Forbid the agent to write a wish similar to an existing one by @yegor256 in https://github.com/yegor256/jinka/pull/182 * Make every skill line direct and consistent with the prompt by @yegor256 in https://github.com/yegor256/jinka/pull/185 * Ask the agent for a JSON answer with summary and link by @yegor256 in https://github.com/yegor256/jinka/pull/186 * Rest a thread between wishes with a visible countdown by @yegor256 in https://github.com/yegor256/jinka/pull/188 …
    在 GitHub 查看 ↗

常见问题

运行 jinka 需要额外的 API 密钥吗?
README 未提及任何密钥配置;它通过 Claude Code 工作,因此相关凭据需求取决于 Claude Code 自身的配置,文档中没有进一步说明。
愿望文件必须放在 ~/.jinka/wishes/ 吗?
README 只演示了该路径下的 Make-Me-Happy.md,未说明是否支持自定义目录或通过参数指定文件。
它可以对哪些仓库或任务生效?
示例仅展示针对一个 GitHub 仓库(foo/bar)的维护愿望,没有列出支持的任务类型或权限范围。
如果愿望执行失败会怎样?
README 没有描述失败提示、重试或回滚机制,需要自行观察运行结果。
Jinka 免费吗?
软件本身免费,但 Jinka 要调用 AI 模型,模型的调用费用由你向模型服务商支付(也可以接本地模型)。
Jinka 开源吗?
开源。源码在 GitHub(yegor256/jinka),许可证是 MIT。
Jinka 安全吗?
FollowAgents 的 FARS 评审(2026年11月18日)给 Jinka 的“信任与安全”打了 10/29 分。评审检查的 8 项安全措施没有完全缺失的。
Jinka 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-18,在最近 30 天内。最新版本是 0.0.14(2026-11-17)。
Jinka 是谁开发的?
Jinka 由 GitHub 账号 yegor256 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念