关于 jb-beans
jb-beans 是使用 Beans Go 命令行工具管理仓库中 Git 友好型 Markdown issue 的技能。它引导 Agent 遵循仓库工作流，维护结构化 issue 关系并谨慎更新内容。
主要功能
- 01使用 beans prime 读取仓库指引
- 02以 JSON 列出和查看 issue
- 03创建和更新 issue
- 04跟踪父级及阻塞关系
- 05通过 --if-match 防止并发覆盖
- 06检查配置与关系
适用场景
- 01查找仓库中可着手处理的 issue
- 02记录实现进度和决策
- 03维护 issue 之间的依赖关系
- 04避免覆盖并发修改的 issue
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/jb-beans确认已加载。
附带文件beans-prime.ts
详细介绍
Beans
使用 beans 管理存储在 .beans/ 中、适合 Git 管理的 Markdown 问题。
从项目指导开始
在 Beans 启用的仓库中开始工作前，请先运行：
beans prime
遵循其输出。它定义了仓库的工作流、问题模型、状态和 Agent 预期，并且优先于此处的通用指导。
安装与二进制安全
通过 Homebrew 或 Go 安装 Go CLI：
brew install hmans/beans/beans
# or
go install github.com/hmans/beans@latest
切勿通过 npm 或 Bun 安装 beans。同名软件包是一个无关的旧版 Node 程序。如果 Beans 意外失败，尤其是出现 coffee-script 模块错误时，请排查命令遮蔽问题：
which -a beans
beans version
必要时，使用可正常工作的 Homebrew 或 Go 二进制文件的绝对路径，并将更广泛的 PATH 修复留在任务范围之外。
Agent 工作流
只要命令支持，就优先使用 --json。典型的生命周期如下：
# Discover actionable or existing work
beans list --json --ready
beans list --json -S "login"
beans show --json <id>
# Create and start work
beans create --json "Add login screen" -t feature -s todo -d "Build the initial login UI"
beans update --json <id> -s in-progress
# Record useful progress
beans update --json <id> --body-append "## Notes\n\nStarted implementation"
# Complete with a durable summary
beans update --json <id> -s completed \
--body-append "## Summary of Changes\n\nImplemented and validated the feature."
及时更新问题正文，记录复现详情、决策、检查清单、进展和最终总结。使用结构化的父级关系和阻塞关系，而不是仅在文字中重复依赖关系。
如果并发编辑可能覆盖内容，请使用范围较窄的正文替换或 --if-match 更新。进行重大配置或关系变更后运行 beans check。仅当项目工作流或用户要求时，才归档工作。
了解当前命令
不要依赖复制来的命令目录。请检查已安装的 CLI，因为支持的字段和标志可能会变化：
beans --help
beans <command> --help
beans version
如需高级筛选和关系遍历，请查看 beans graphql --help 和 beans graphql --schema。Beans 没有内置的 beans tui；如有需要，请使用独立的 beans-tui 工具。