关于 difit-dev
通过 difit 本地网页界面请求用户审查 Git 更改的技能。它支持提交、暂存区及未暂存更改的差异视图,并返回评论以便后续处理。
主要功能
- 01在网页审查视图中显示差异
- 02审查提交、暂存和未暂存更改
- 03为差异附加启动评论
- 04在审查中包含未跟踪文件
适用场景
- 01提交更改前请求审查
- 02比较两个提交或分支
- 03收集暂存区或工作区差异的评论
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ yoshiko-pg/ difit --skill difit-dev安装后在 Claude Code 中输入/difit-dev确认已加载。
详细介绍
Difit Dev
概述
此技能通过在此仓库中运行 pnpm run dev,向用户请求代码审查。
运行一次 pnpm run dev 即可启动审查请求工作流。
不要自行打开浏览器、确认浏览器是否已连接,或仅为保持服务器运行而重启服务器。
如果用户留下审查意见,这些意见会在 difit 命令退出时打印到 stdout。
收到审查意见后,继续工作并处理这些意见。
如果服务器关闭时没有意见,则视为“未提供审查意见”。无需重启服务器。
如果没有意见,并出现 Client disconnected, shutting down server...,则视为成功完成且没有审查意见。
也无需手动确认页面是否正确启动。
命令
- 提交前审查未提交的更改:
pnpm run dev . - 审查 HEAD 提交:
pnpm run dev - 审查暂存区中的更改:
pnpm run dev staged - 仅审查未暂存的更改:
pnpm run dev working
基本用法:
pnpm run dev <target> # View single commit diff. ex: pnpm run dev 6f4a9b7
pnpm run dev <target> [compare-with] # Compare two commits/branches. ex: pnpm run dev feature main
可选的启动评论
如果你想在 difit 打开时向用户说明某些内容,可以使用 --comment 将其作为启动评论附加。
这适用于审查发现、说明,以及用户需要直接在差异中看到的任何上下文。
pnpm run dev <target> [compare-with] \
--comment '{"type":"thread","filePath":"src/foobar.ts","position":{"side":"old","line":102},"body":"line 1\nline 2"}' \
--comment '{"type":"thread","filePath":"src/example.ts","position":{"side":"new","line":{"start":36,"end":39}},"body":"Range comment for L36-L39"}'
- 在此仓库中,不要在
pnpm run dev后插入--。pnpm run dev -- ...会导致参数解析出错。 - 每条评论都使用
type: "thread"。 - 使用用户所用的语言撰写评论正文。
- 对于存在于差异目标侧的行,使用
position.side: "new"。 - 对于仅存在于已删除侧的行,使用
position.side: "old"。 - 对于涉及多行的问题,使用范围评论。
- 绝不要将差异中的机密、令牌、密码、API 密钥、私钥或其他类似凭据的内容复制到
--comment正文或任何命令行参数中。
包含未跟踪文件
对于未提交的更改,如果还应在差异中显示尚未添加到 git 的文件,请添加 --include-untracked。
pnpm run dev . --include-untracked
限制
只能在此 Git 管理的仓库中使用。
评论
支持 Markdown