Jinka
把一个 Markdown 愿望文件交给 Claude Code,由命令行让 GitHub 仓库按你的想法变好。
- Star 数
- ★ 20
- 最近更新
- 3 天前
- License
- MIT
- 主语言
- JavaScript
- FA 评分
- 41/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 已经使用 Claude Code,希望把重复性的仓库维护任务写成可复用 Markdown 指令的开发者。
- 不适合
- 不希望依赖 Claude Code 的团队
- 需要图形界面或浏览器操作的用户
- 要求模型供应商可自由切换的组织
- 维护状态
- 近 30 天有提交最近提交 2026-11-18最新版本 0.0.14(2026-11-17)
- 源码审查
- 41/100 · 缺口较多
这个 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 未说明输出格式、日志位置或失败重试机制。
- 已经使用 Claude Code,希望把重复性的仓库维护任务写成可复用 Markdown 指令的开发者。
- 想在终端里用一句自然语言描述来触发 GitHub 仓库检查或整理的维护者。
- 偏好文件即配置、不愿学习复杂 CLI 参数的个人开发者。
- 需要把多个日常开发愿望集中存放在 ~/.jinka/wishes/ 下批量执行的工程师。
- 评估轻量级 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`.第二步,直接运行:
jinkaREADME 未说明是否会提示选择愿望、是否一次性执行所有文件,也未给出额外参数。
这个 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?
查看各维度的扣分理由
技能文件对合并、发 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。
技能文本内部一致:各技能都声明“不构建、不测试、不派发子代理”,与 CLAUDE.md 的 README 约束不冲突,self_consistency 得 2。依赖可用性方面 engines 要求 Node>=20.12,依赖用 ^ 浮动范围且无 lockfile,dependency_availability 得 1。失败信息方面测试断言带有可读消息,但产品运行时对用户可见的错误提示在样本中不可见,failure_messages 得 1。
技能描述给出了清晰的触发短语(“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。
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。
技能输出规范(标题格式、片段引用、简洁措辞)使产出可直接用于 GitHub,output_usability 得 2。但产品价值依赖外部 Claude Code 与 gh 凭据,且自动合并/发 issue 的边际价值在缺少评测证据下只能算中等,marginal_value 得 1;成本方面每次运行需调用模型并访问 GitHub API,未见成本控制说明,cost_benefit 得 1。
技能中的门禁条件(审批评审、检查状态)可追溯到 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,接口与行为可能不稳定;发布者身份未经验证。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
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 查看 ↗ -
发布说明摘录
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 查看 ↗ -
发布说明摘录
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 密钥吗?
愿望文件必须放在 ~/.jinka/wishes/ 吗?
它可以对哪些仓库或任务生效?
如果愿望执行失败会怎样?
Jinka 免费吗?
Jinka 开源吗?
Jinka 安全吗?
Jinka 还在维护吗?
Jinka 是谁开发的?
谢谢反馈,我们会据此改进页面。