mcpField
W
wjs-looping-feedback

wjs-looping-feedback

github.com/jianshuoAgent 工作流13792 次安装今天更新
代码仓库

关于 wjs-looping-feedback

wjs-looping-feedback 为网站仓库安装基于 GitHub Issues 和 Actions 的反馈处理循环，面向希望在自有仓库中处理访客建议的站点维护者。Claude Code 按仓库指令修改网站，并记录变更、部署状态与回滚入口。

主要功能

  1. 01悬浮反馈按钮并预填 GitHub Issue
  2. 02通过允许名单限制反馈处理者
  3. 03由 Claude Code Action 修改网站
  4. 04自动提交并更新反馈记录与仪表板
  5. 05支持通过反馈 Issue 发起回滚

适用场景

  1. 01收集网站访客对页面的修改建议
  2. 02在自有 GitHub Actions 中自动应用获准反馈
  3. 03查看建议对应的修改提交并执行回滚

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jianshuo/claude-skills --skill wjs-looping-feedback

安装后在 Claude Code 中输入/wjs-looping-feedback确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
package.json
README.md
assets/
config.sample.json
feedback-finalize.mjs
feedback-ledger.json
feedback-lib.mjs
feedback-widget.html
feedback.yml
INSTRUCTIONS.md
references/
install.md
scripts/
detect-site.mjs
tests/
detect-site.test.mjs
finalize.test.mjs
lib.test.mjs

详细介绍

wjs-looping-feedback

在任意网站仓库中安装一个自动反馈循环。整个流程均在仓库所有者自己的 GitHub Actions 中运行，并使用其 Pro/Max OAuth 令牌或自己的 ANTHROPIC_API_KEY 进行身份验证——无需额外的服务或后端。

安装内容

  1. 一个悬浮反馈按钮（预填 GitHub Issue——无需后端，客户端无需密钥）。
  2. .github/workflows/feedback.yml——允许名单检查 → Claude Code Action → 自动提交 → 推送到 main（自动部署）→ 更新日志和仪表板 → 关闭 Issue。
  3. /_feedback 仪表板——展示每条建议、Claude 的处理结果、提交记录、状态，以及一键还原功能。
  4. .feedback/ 运行时文件：feedback-lib.mjs、feedback-finalize.mjs、INSTRUCTIONS.md、feedback-ledger.json、config.json。

工作原理

访客点击按钮 → 填写建议 → 创建预填好的 GitHub Issue（标签为 feedback）→ Actions 检查作者是否在 FEEDBACK_ALLOWLIST 中（否则关闭 Issue）→ Claude Code 根据 .feedback/INSTRUCTIONS.md 编辑网站 → 工作流提交到 main， 更新日志和仪表板 → 部署流程发布更改 → 在 Issue 中添加评论，包含提交记录和指向 /_feedback 的链接。 还原操作使用相同的循环，由 revert: #N Issue 触发。

触发部署——安装前请阅读（常见问题）

工作流使用内置的 GITHUB_TOKEN 推送到 main。分两种情况：

  • 外部推送部署平台（Cloudflare Pages git-connect、Vercel、Netlify）：它们的 webhook 会在每次推送时触发，因此机器人的提交会自动部署。无需进行任何操作。
  • 部署本身是同一仓库中的 GitHub Actions 工作流（例如通过 Actions 部署 GitHub Pages）：GitHub 会特意阻止 GITHUB_TOKEN 推送触发其他工作流 （防止递归），因此部署工作流中的 on: push 不会触发——更改会进入 main，但永远不会上线。可通过在 部署工作流中添加 workflow_run 触发器来解决（参见 references/install.md 步骤 4.5）。

安装方法

阅读 references/install.md，并在目标仓库中按其说明操作。它会检测网站类型 （Hugo / Next.js / Astro / 静态网站）、复制资源、注入小组件，并要求用户提供 且只需提供两项内容：GitHub 用户名允许名单和身份验证信息（通过 claude setup-token 获取的 Pro/Max OAuth 令牌，或 ANTHROPIC_API_KEY）。

范围（路线 1）

在用户自己的仓库中使用其自己的身份验证信息运行。提交者需要拥有 GitHub 账号；只有列入允许名单的作者才能触发处理。这不是托管服务——不支持匿名提交、没有计费，也不支持多租户。（未来打包为 GitHub App 时可复用此处的所有资源。）

评论

支持 Markdown