[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-steipete--agent-scripts":3,"tool-steipete--agent-scripts":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",149489,2,"2026-04-10T11:32:46",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":77,"owner_email":78,"owner_twitter":72,"owner_website":79,"owner_url":80,"languages":81,"stars":98,"forks":99,"last_commit_at":100,"license":101,"difficulty_score":102,"env_os":103,"env_gpu":104,"env_ram":104,"env_deps":105,"category_tags":111,"github_topics":112,"view_count":32,"oss_zip_url":114,"oss_zip_packed_at":114,"status":17,"created_at":115,"updated_at":116,"faqs":117,"releases":118},6202,"steipete\u002Fagent-scripts","agent-scripts","Scripts for agents, shared between my repositories.","agent-scripts 是一套专为 AI 代理（Agent）设计的共享脚本与规范集合，旨在统一多个项目中的开发辅助流程。它主要解决了在多仓库协作中，如何高效复用“护栏”逻辑（如提交规范、文档检查）以及保持各仓库配置一致性的难题。通过引入“指针式”配置文件，开发者只需在子项目中引用中央规则，即可自动同步最新的共享指令，无需重复复制代码块，极大降低了维护成本。\n\n这套工具特别适合需要在多个仓库间协调工作的软件开发者和工程团队，尤其是那些深度依赖 AI 辅助编程并追求工作流标准化的技术人群。其技术亮点包括：轻量级的 Bash 提交助手，能强制规范提交信息；基于 TypeScript 的文档列表生成器，自动校验文档元数据；以及一个独立的 Chrome 浏览器自动化工具，无需复杂的外部 CLI 即可实现页面导航、截图和内容提取。所有脚本均设计为无外部依赖、可独立运行，确保了在不同项目环境中的高度便携性与稳定性，是构建标准化 AI 开发工作流的实用基石。","# Agent Scripts\n\nThis folder collects the Sweetistics guardrail helpers so they are easy to reuse in other repos or share during onboarding. Everything here is copied verbatim from `\u002FUsers\u002Fsteipete\u002FProjects\u002Fsweetistics` on 2025-11-08 unless otherwise noted.\n\nAdditional skills (copied 2025-12-31) are from @Dimillian’s public `Dimillian\u002FSkills` repository:\n- `skills\u002Fswift-concurrency-expert`\n- `skills\u002Fswiftui-liquid-glass`\n- `skills\u002Fswiftui-performance-audit`\n- `skills\u002Fswiftui-view-refactor`\n\n## Syncing With Other Repos\n- Treat this repo as the canonical mirror for the shared guardrail helpers. Whenever you edit `scripts\u002Fcommitter` or `scripts\u002Fdocs-list.ts` in any repo, copy the change here and then back out to every other repo that carries the same helpers so they stay byte-identical.\n- When someone says “sync agent scripts,” pull the latest changes here, ensure downstream repos have the pointer-style `AGENTS.MD`, copy any helper updates into place, and reconcile differences before moving on.\n- Keep every file dependency-free and portable: the scripts must run in isolation across repos. Do not add `tsconfig` path aliases, shared source folders, or any other Sweetistics-specific imports—inline tiny helpers or duplicate the minimum code needed so the mirror stays self-contained.\n\n## Pointer-Style AGENTS\n- Shared guardrail text now lives only inside this repo: `AGENTS.MD` (shared rules + tool list).\n- Every consuming repo’s `AGENTS.MD` is reduced to the pointer line `READ ~\u002FProjects\u002Fagent-scripts\u002FAGENTS.MD BEFORE ANYTHING (skip if missing).` Place repo-specific rules **after** that line if they’re truly needed.\n- Do **not** copy the `[shared]` or `\u003Ctools>` blocks into other repos anymore. Instead, keep this repo updated and have downstream workspaces re-read `AGENTS.MD` when starting work.\n- When updating the shared instructions, edit `agent-scripts\u002FAGENTS.MD`, mirror the change into `~\u002FAGENTS.MD` (Codex global), and let downstream repos continue referencing the pointer.\n\n## Committer Helper (`scripts\u002Fcommitter`)\n- **What it is:** Bash helper that stages exactly the files you list, enforces non-empty commit messages, and creates the commit.\n\n## Docs Lister (`scripts\u002Fdocs-list.ts`)\n- **What it is:** tsx script that walks `docs\u002F`, enforces front-matter (`summary`, `read_when`), and prints the summaries surfaced by `pnpm run docs:list`. Other repos can wire the same command into their onboarding flow.\n- **Binary build:** `bin\u002Fdocs-list` is the compiled Bun CLI; regenerate it after editing `scripts\u002Fdocs-list.ts` via `bun build scripts\u002Fdocs-list.ts --compile --outfile bin\u002Fdocs-list`.\n\n## Browser Tools (`bin\u002Fbrowser-tools`)\n- **What it is:** A standalone Chrome helper inspired by Mario Zechner’s [“What if you don’t need MCP?”](https:\u002F\u002Fmariozechner.at\u002Fposts\u002F2025-11-02-what-if-you-dont-need-mcp\u002F) article. It launches\u002Finspects DevTools-enabled Chrome profiles, pastes prompts, captures screenshots, and kills stray helper processes without needing the full Oracle CLI.\n- **Usage:** Prefer the compiled binary: `bin\u002Fbrowser-tools --help`. Common commands include `start --profile`, `nav \u003Curl>`, `eval '\u003Cjs>'`, `screenshot`, `search --content \"\u003Cquery>\"`, `content \u003Curl>`, `inspect`, and `kill --all --force`.\n- **Rebuilding:** The binary is not tracked in git. Re-generate it with `bun build scripts\u002Fbrowser-tools.ts --compile --target bun --outfile bin\u002Fbrowser-tools` (requires Bun) and leave transient `node_modules`\u002F`package.json` out of the repo.\n- **Portability:** The tool has zero repo-specific imports. Copy the script or the binary into other automation projects as needed and keep this copy in sync with downstream forks. It detects Chrome sessions launched via `--remote-debugging-port` **and** `--remote-debugging-pipe`, so list\u002Fkill works for both styles.\n\n## Sync Expectations\n- This repository is the canonical mirror for the guardrail helpers used in mcporter and other Sweetistics projects. Whenever you edit `scripts\u002Fcommitter`, `scripts\u002Fdocs-list.ts`, or related guardrail files in another repo, copy the changes back here immediately (and vice versa) so the code stays byte-identical.\n- When someone asks to “sync agent scripts,” update this repo, compare it against the active project, and reconcile differences in both directions before continuing.\n\n## @steipete Agent Instructions (pointer workflow)\n- The only full copies of the guardrails are `agent-scripts\u002FAGENTS.MD` and `~\u002FAGENTS.MD`. Downstream repos should contain the pointer line plus any repo-local additions.\n- During a sync sweep: pull latest `agent-scripts`, ensure each target repo’s `AGENTS.MD` contains the pointer line at the top, append any repo-local notes beneath it, and update the helper scripts as needed.\n- If a repo needs custom instructions, clearly separate them from the pointer so future sweeps don’t overwrite local content.\n- For submodules (Peekaboo\u002F*), repeat the pointer check inside each subrepo, push those changes, then bump submodule SHAs in the parent repo.\n- Skip experimental repos (e.g., `poltergeist-pitui`) unless explicitly requested.\n","# 代理脚本\n\n此文件夹收集了 Sweetistics 的护栏辅助工具，以便在其他仓库中轻松复用，或在入职培训期间共享。除非另有说明，此处的所有内容均于 2025 年 11月 8 日从 `\u002FUsers\u002Fsteipete\u002FProjects\u002Fsweetistics` 原样复制而来。\n\n额外的技能（于 2025 年 12 月 31 日复制）来自 @Dimillian 的公共 `Dimillian\u002FSkills` 仓库：\n- `skills\u002Fswift-concurrency-expert`\n- `skills\u002Fswiftui-liquid-glass`\n- `skills\u002Fswiftui-performance-audit`\n- `skills\u002Fswiftui-view-refactor`\n\n## 与其他仓库同步\n- 将此仓库视为共享护栏辅助工具的规范镜像。每当您在任何仓库中编辑 `scripts\u002Fcommitter` 或 `scripts\u002Fdocs-list.ts` 时，请将更改复制到这里，然后再反向应用到所有包含相同辅助工具的其他仓库，以确保它们字节完全一致。\n- 当有人提到“同步代理脚本”时，请拉取此处的最新更改，确保下游仓库拥有指针式的 `AGENTS.MD` 文件，将任何辅助工具的更新复制到位，并在继续之前解决差异。\n- 保持每个文件无依赖且可移植：这些脚本必须能够在各个仓库中独立运行。请勿添加 `tsconfig` 路径别名、共享源代码文件夹或其他任何 Sweetistics 特有的导入——应内联小型辅助函数，或仅复制所需的最少代码，以使镜像保持自包含。\n\n## 指针式 AGENTS\n- 共享的护栏文本现在仅存在于此仓库中：`AGENTS.MD`（共享规则 + 工具列表）。 \n- 每个使用仓库的 `AGENTS.MD` 都简化为指针行：“在进行任何操作之前，请阅读 ~\u002FProjects\u002Fagent-scripts\u002FAGENTS.MD（如果不存在则跳过）。” 如果确实需要，可在该行之后添加仓库特定的规则。\n- **请勿**再将 `[shared]` 或 `\u003Ctools>` 块复制到其他仓库。相反，应保持此仓库的更新，并让下游工作区在开始工作时重新读取 `AGENTS.MD`。\n- 更新共享说明时，编辑 `agent-scripts\u002FAGENTS.MD`，将更改镜像到 `~\u002FAGENTS.MD`（Codex 全局），并让下游仓库继续引用该指针。\n\n## 提交者辅助工具 (`scripts\u002Fcommitter`)\n- **是什么：** 一个 Bash 辅助工具，用于精确暂存您列出的文件，强制提交信息不为空，并创建提交。\n\n## 文档列表工具 (`scripts\u002Fdocs-list.ts`)\n- **是什么：** 一个 tsx 脚本，遍历 `docs\u002F` 目录，强制执行 front-matter（`summary`、`read_when`），并打印由 `pnpm run docs:list` 输出的摘要。其他仓库可以将相同的命令集成到其入职流程中。\n- **二进制构建：** `bin\u002Fdocs-list` 是编译后的 Bun CLI；在编辑 `scripts\u002Fdocs-list.ts` 后，通过 `bun build scripts\u002Fdocs-list.ts --compile --outfile bin\u002Fdocs-list` 重新生成。\n\n## 浏览器工具 (`bin\u002Fbrowser-tools`)\n- **是什么：** 一个独立的 Chrome 辅助工具，灵感来源于 Mario Zechner 的文章《如果你不需要 MCP 会怎样？》。它可以启动或检查启用了 DevTools 的 Chrome 配置文件，粘贴提示信息，截取屏幕截图，并终止多余的辅助进程，而无需完整的 Oracle CLI。\n- **使用方法：** 建议使用编译后的二进制文件：`bin\u002Fbrowser-tools --help`。常用命令包括 `start --profile`、`nav \u003Curl>`、`eval '\u003Cjs>'`、`screenshot`、`search --content \"\u003Cquery>\"`、`content \u003Curl>`、`inspect` 和 `kill --all --force`。\n- **重建：** 该二进制文件未被 Git 跟踪。可通过 `bun build scripts\u002Fbrowser-tools.ts --compile --target bun --outfile bin\u002Fbrowser-tools` 重新生成（需要 Bun），并将临时的 `node_modules`\u002F`package.json` 排除在仓库之外。\n- **可移植性：** 该工具没有任何仓库特定的依赖项。您可以根据需要将脚本或二进制文件复制到其他自动化项目中，并保持与下游分支的同步。它能够检测通过 `--remote-debugging-port` 和 `--remote-debugging-pipe` 启动的 Chrome 会话，因此无论哪种方式，都可以正常列出和终止进程。\n\n## 同步期望\n- 此仓库是 mcporter 及其他 Sweetistics 项目中使用的护栏辅助工具的规范镜像。每当您在其他仓库中编辑 `scripts\u002Fcommitter`、`scripts\u002Fdocs-list.ts` 或相关护栏文件时，都应立即将更改复制回此处（反之亦然），以确保代码字节完全一致。\n- 当有人要求“同步代理脚本”时，请更新此仓库，将其与当前项目进行比较，并在继续之前解决双方的差异。\n\n## @steipete 代理说明（指针式流程）\n- 护栏的完整副本只有 `agent-scripts\u002FAGENTS.MD` 和 `~\u002FAGENTS.MD`。下游仓库应包含指针行以及任何仓库本地的补充内容。\n- 在同步扫描过程中：拉取最新的 `agent-scripts`，确保每个目标仓库的 `AGENTS.MD` 文件顶部包含指针行，在其下方添加任何仓库本地的备注，并根据需要更新辅助脚本。\n- 如果某个仓库需要自定义说明，务必将其与指针明确分开，以免未来的同步扫描覆盖本地内容。\n- 对于子模块（Peekaboo\u002F*），应在每个子模块内部重复检查指针，推送这些更改，然后在父仓库中更新子模块的 SHA 值。\n- 除非特别要求，否则请跳过实验性仓库（例如 `poltergeist-pitui`）。","# agent-scripts 快速上手指南\n\n`agent-scripts` 是 Sweetistics 项目的一套标准化 AI 辅助工具集（Guardrail Helpers），旨在为多个仓库提供可复用的脚本、浏览器自动化工具以及统一的 Agent 指令规范。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**: macOS 或 Linux (Windows 需配合 WSL 使用)。\n*   **运行时依赖**:\n    *   **Bun**: 用于编译和运行 TypeScript 脚本及二进制文件（推荐）。\n    *   **Node.js**: 如果未安装 Bun，需确保安装了 Node.js 和 `tsx`。\n    *   **pnpm**: 部分脚本依赖 pnpm 运行。\n*   **浏览器**: Google Chrome (用于 `browser-tools` 功能)。\n*   **Shell**: Bash 或 Zsh (用于 `committer` 脚本)。\n\n> **提示**：国内开发者若下载 Bun 较慢，可使用国内镜像源安装：\n> ```bash\n> curl -fsSL https:\u002F\u002Fbun.sh\u002Finstall | bash\n> # 若上述命令超时，可尝试配置 npm 镜像后安装 bun 包\n> npm config set registry https:\u002F\u002Fregistry.npmmirror.com\n> npm install -g bun\n> ```\n\n## 安装步骤\n\n由于该工具库设计为“规范镜像（Canonical Mirror）”，通常通过克隆仓库并集成到现有项目中使用。\n\n1.  **克隆仓库**\n    ```bash\n    git clone \u003Cyour-repo-url>\u002Fagent-scripts.git\n    cd agent-scripts\n    ```\n\n2.  **安装依赖**\n    ```bash\n    pnpm install\n    ```\n\n3.  **编译二进制工具**\n    为了获得最佳性能，需要将 TypeScript 脚本编译为独立二进制文件。\n    \n    *   编译文档列表工具 (`docs-list`)：\n        ```bash\n        bun build scripts\u002Fdocs-list.ts --compile --outfile bin\u002Fdocs-list\n        ```\n    *   编译浏览器自动化工具 (`browser-tools`)：\n        ```bash\n        bun build scripts\u002Fbrowser-tools.ts --compile --target bun --outfile bin\u002Fbrowser-tools\n        ```\n\n4.  **集成到现有项目 (同步规范)**\n    若要在其他项目中使用，需执行“指针式”同步：\n    *   将 `scripts\u002F` 和 `bin\u002F` 目录复制到目标项目。\n    *   在目标项目的 `AGENTS.MD` 文件**首行**添加以下指针（替换为您的实际路径）：\n        ```text\n        READ ~\u002FProjects\u002Fagent-scripts\u002FAGENTS.MD BEFORE ANYTHING (skip if missing).\n        ```\n    *   确保目标项目中的脚本文件与此仓库保持字节级一致（byte-identical）。\n\n## 基本使用\n\n### 1. 提交助手 (Committer Helper)\n用于严格规范 Git 提交行为，确保只暂存指定文件且提交信息非空。\n\n```bash\n# 用法示例：暂存特定文件并提交\n.\u002Fscripts\u002Fcommitter file1.ts file2.md -m \"feat: update documentation\"\n```\n\n### 2. 文档列表生成 (Docs Lister)\n遍历 `docs\u002F` 目录，检查 Front-matter（如 `summary`, `read_when`），并输出摘要列表。常用于新员工入职流程。\n\n```bash\n# 运行脚本查看文档摘要\npnpm run docs:list\n\n# 或直接使用编译后的二进制文件\n.\u002Fbin\u002Fdocs-list\n```\n\n### 3. 浏览器自动化工具 (Browser Tools)\n独立的 Chrome 辅助工具，无需完整的 MCP 客户端即可启动调试配置文件、执行 JS、截图或检索内容。\n\n*   **查看帮助**\n    ```bash\n    .\u002Fbin\u002Fbrowser-tools --help\n    ```\n\n*   **常用命令示例**\n    *   启动特定配置的 Chrome 进程：\n        ```bash\n        .\u002Fbin\u002Fbrowser-tools start --profile \"DevProfile\"\n        ```\n    *   导航至指定 URL：\n        ```bash\n        .\u002Fbin\u002Fbrowser-tools nav \"https:\u002F\u002Fexample.com\"\n        ```\n    *   执行 JavaScript 代码：\n        ```bash\n        .\u002Fbin\u002Fbrowser-tools eval \"document.title\"\n        ```\n    *   截取屏幕快照：\n        ```bash\n        .\u002Fbin\u002Fbrowser-tools screenshot\n        ```\n    *   搜索页面内容：\n        ```bash\n        .\u002Fbin\u002Fbrowser-tools search --content \"keyword\"\n        ```\n    *   强制关闭所有残留的助手进程：\n        ```bash\n        .\u002Fbin\u002Fbrowser-tools kill --all --force\n        ```\n\n> **注意**：`browser-tools` 支持检测通过 `--remote-debugging-port` 和 `--remote-debugging-pipe` 启动的 Chrome 会话。","某 iOS 开发团队在维护多个 Swift 项目时，需要统一 AI 助手的代码审查标准并自动化文档管理流程。\n\n### 没有 agent-scripts 时\n- **规则同步困难**：每个仓库的 `AGENTS.MD` 文件独立维护，更新共享的 Guardrail（护栏）规则时需手动逐个修改，极易出现版本不一致。\n- **提交规范混乱**：缺乏统一的提交辅助脚本，开发者常忘记暂存特定文件或编写空的提交信息，导致 Git 历史杂乱。\n- **文档维护繁琐**：检查 `docs\u002F` 目录下 Front-matter（如 `summary` 字段）是否合规全靠人工肉眼排查，效率低且易遗漏。\n- **浏览器自动化门槛高**：想要让 AI 自动操作 Chrome 进行页面测试或截图，需配置复杂的 MCP 服务或依赖重型 CLI 工具，难以快速落地。\n- **环境依赖冲突**：各项目的辅助脚本往往耦合了特定路径或配置文件，无法直接复用到新项目中，重复造轮子现象严重。\n\n### 使用 agent-scripts 后\n- **规则一键同步**：通过“指针式”`AGENTS.MD` 机制，所有下游仓库仅需引用一行指令即可实时获取最新的共享规则，确保全团队标准严格一致。\n- **提交自动合规**：集成 `scripts\u002Fcommitter` 助手，自动强制暂存指定文件并校验提交信息非空，从源头保证 Git 提交的规范性。\n- **文档自动审计**：运行 `docs-list.ts` 脚本即可自动遍历文档目录，即时报告缺失的元数据字段，将文档合规检查纳入自动化流。\n- **轻量浏览器操控**：利用编译好的 `bin\u002Fbrowser-tools` 二进制文件，无需复杂配置即可直接启动 Chrome、执行 JS 或截取屏幕，大幅降低自动化测试难度。\n- **零依赖便携复用**：所有脚本设计为无外部依赖的独立单元，可像积木一样直接复制到任何新仓库中立即运行，彻底消除环境适配成本。\n\nagent-scripts 通过将分散的运维逻辑标准化为可复用的原子脚本，显著降低了多仓库协作中的管理摩擦与自动化门槛。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsteipete_agent-scripts_1ad8dd18.png","steipete","Peter Steinberger","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fsteipete_d1c5c0c3.jpg","Came back from retirement to mess with AI. Clawdfather @OpenClaw\r\n\r\nPreviously: Founder of @PSPDFKit.","Full-Time Open-Sourcerer","Vienna & London","peter@steipete.me","http:\u002F\u002Fsteipete.me","https:\u002F\u002Fgithub.com\u002Fsteipete",[82,86,90,94],{"name":83,"color":84,"percentage":85},"Python","#3572A5",39.5,{"name":87,"color":88,"percentage":89},"TypeScript","#3178c6",34.2,{"name":91,"color":92,"percentage":93},"JavaScript","#f1e05a",16.4,{"name":95,"color":96,"percentage":97},"Shell","#89e051",9.9,2375,241,"2026-04-10T04:58:26","NOASSERTION",4,"macOS","未说明",{"notes":106,"python":104,"dependencies":107},"该工具集主要面向 macOS 环境（路径示例包含 \u002FUsers\u002F），核心依赖为 Bun 运行时（用于编译和运行 TypeScript 脚本）和 Chrome 浏览器。其中 browser-tools 组件需要启动支持远程调试端口或管道的 Chrome 实例。项目强调脚本的独立性和无依赖性，不包含特定于框架的导入。",[108,109,110],"Bun","tsx","Chrome (DevTools enabled)",[13],[113],"ai-agents",null,"2026-03-27T02:49:30.150509","2026-04-10T20:32:23.587646",[],[]]