poorcoder 是一组轻量级 Bash 脚本集合，旨在通过 AI 辅助增强你的编码工作流。这些工具在网页版 AI 界面与终端之间架起桥梁，让你在不打断开发流程的情况下，利用基于订阅的 LLM（如 Claude.ai 或 Grok）。
用途与定位
poorcoder 专为使用网页版 LLM 订阅、同时希望保持终端工作流的开发者设计。与 IDE 集成方案（Cursor、aider、Claude Code 等）不同，它不依赖专用 API，而是配合你已有的网页/移动端 LLM 订阅使用，被认为比专用 API 更经济，同时保留终端开发方式和网页/移动端 LLM 的交互体验。其设计遵循 Unix 哲学，即小而专的工具各司其职。
主要能力（四个核心工具）
-
context —— 代码上下文生成器：从项目中提取相关代码上下文，以便发送给网页版 LLM。
-
apply-md —— Markdown 代码应用器：从 Markdown（通常是 LLM 回复）中提取代码块，并将变更应用到文件系统。
-
git-context —— Git 上下文生成器：生成与 git 相关的上下文，帮助 LLM 编写有意义的提交信息。
-
autocommit —— 自动化 AI 提交信息生成器：使用 git-context 自动创建带有 AI 生成提交信息的提交。该脚本是一个简单包装器，它使用 git-context 收集变更信息，通过 llm CLI 工具将上下文传给 LLM，用生成的提交信息执行 git commit，并打开编辑器供你在最终确认前审阅/编辑信息。该脚本需要安装 llm CLI 工具并配置合适的 LLM 模型。
安装方式
标准安装：克隆本仓库并使脚本可执行。你可以直接在该文件夹中使用脚本，或将其添加到 PATH 以便全局访问。
项目专属安装（推荐）：对于高频使用，可将脚本和 prompts 目录直接复制到你的项目中。此方式允许你针对特定项目工作流自定义脚本和提示词。你还可以创建自定义别名或包装脚本。
使用方式与工作流
poorcoder 支持两种主要工作流：
- 网页 LLM 工作流：适合复杂交互并充分利用你的 LLM 订阅。
- LLM CLI 工作流：适合快速操作或使用 LLM CLI 工具进行自动化。
场景示例：复杂项目中的 Bug 修复
-
收集相关上下文： ./context --include="src/utils/validation.js" --include="src/components/Form.js" | pbcopy
-
粘贴到 Claude.ai 或 Grok 并附上请求：“表单验证在提交空字符串时失败，请在保持现有验证方式的前提下修复它。”
-
复制 AI 的回复并应用变更： pbpaste | ./apply-md --dry-run # 预览变更 pbpaste | ./apply-md # 应用变更
-
使用 autocommit 生成提交信息： ./autocommit # 自动生成提交信息并打开编辑器
与其他工具的集成
poorcoder 可与多种工具配合，形成无缝工作流：
- 网页 LLM：Claude.ai、ChatGPT、Grok 等
- LLM CLI 工具：llm、sgpt、chatgpt-cli 等
- 剪贴板工具：pbcopy / pbpaste（macOS）、xclip（Linux）
- 版本控制：git
适用场景与限制
适用场景：已有网页版 LLM 订阅、偏好终端工作流、希望避免专用 API 高额费用的开发者；需要提取项目上下文、应用 LLM 生成的代码变更、生成 AI 提交信息的日常开发任务。
限制：仓库资料中未说明对操作系统、shell 版本、具体 LLM 模型或收费价格的具体要求。autocommit 明确依赖 llm CLI 工具的安装与配置。其余脚本的完整文档、参数细节和依赖项资料中未提供，建议查阅仓库中各工具的完整文档。
许可与贡献
项目采用 The Unlicense（公有领域）许可。欢迎提交 pull request 或 issue 以提出改进建议。
