Plannotator 接入 Kiro CLI 实战：Skills 自动安装与 plannotator 自定义 Agent

【免费下载链接】plannotatorAnnotate and review coding agent plans and code diffs visually, share with your team, send feedback to agents with one click.项目地址https://gitcode.com/gh_mirrors/pl/plannotator点击查看免费下载本篇指南基于 Plannotator 官方文档 Kiro CLI 及其配套源码包 apps/kiro-cli完整讲解 Kiro CLI 如何以「按需调用的可安装 skills 示例自定义 agent」的方式接入 Plannotator包括自动检测与安装流程、每个已安装 skill 的实际命令形态、plannotator自定义 agent 的完整 JSON 配置及其逐字段原理以及应对 Kiro schema 演变的适配建议。读完你可以零配置地为 Kiro CLI 装上 Plannotator 的代码评审与文档批注能力并能自行编写一个复用这些 skill 的 agent。接入方式总览按需调用的 Skills而非后台钩子Plannotator 支持 Kiro CLI 的方式是「可安装的 skills 加上一个示例自定义 agent」。skills 在需要时由模型或用户显式调用没有任何后台 hooks——这与 Plannotator 集成 Droid 和 Copilot CLI 的模式一致。从源码结构看Kiro 集成是一个独立的源码包 apps/kiro-cli其中的文件由主安装器 scripts/install.sh 消费不存在单独的 Kiro 安装器Kiro 用户与所有其他 agent 用户执行同一条安装命令即可。该包包含三类内容skills/ — Kiro 专属 skill 包plannotator-review、plannotator-annotate各自把PLANNOTATOR_ORIGINkiro-cli硬编码进命令agents/plannotator.json — 示例 Kiro 自定义 agent通过skill://resources 暴露 Plannotator 全部 skills并限定plannotator命令的shell工具共享扩展 skillsplannotator-setup-goal、plannotator-visual-explainer直接从仓库的apps/skills/extra/目录安装不在 Kiro 包里重复维护。README 中有一条明确的源码维护约定Kiro 专属的 skill 副本是故意独立的因为要硬编码PLANNOTATOR_ORIGINkiro-cli被豁免于「单一来源」原则不能用apps/skills/core/下的核心副本替换。安装自动检测 Kiro一条命令完成自动检测逻辑Kiro 是自动检测的当运行安装器时只要~/.kiro目录存在或kiro-cli在 PATH 中Kiro skills 就会自动安装——这是 Codex 和 Gemini 使用的同一套约定无需任何额外参数。安装器中的检测逻辑见 scripts/install.shkiro_available0 if command -v kiro-cli /dev/null 21 || [ -d $HOME/.kiro ]; then kiro_available1自动检测在所有平台生效使用你操作系统对应的安装器即可macOS / Linux / WSLcurl -fsSL https://plannotator.ai/install.sh | bashWindows PowerShellirm https://plannotator.ai/install.ps1 | iexWindows CMDcurl -fsSL https://plannotator.ai/install.cmd -o install.cmd install.cmd del install.cmd安装到哪些位置安装器把 Kiro skills 写入~/.kiro/skills把 Plannotator agent 写入~/.kiro/agents/plannotator.json。如果安装 Plannotator之后才安装 Kiro只需重新运行一次安装器即可补装。从 scripts/install.sh 的安装块可以看到完整的落盘行为if [ $kiro_available -eq 1 ] [ $skip_kiro -eq 0 ] [ -d apps/kiro-cli/skills ]; then mkdir -p $KIRO_SKILLS_DIR # Kiro-specific skills (origin baked in) come from apps/kiro-cli/skills. copy_skill_if_present apps/kiro-cli/skills/plannotator-review $KIRO_SKILLS_DIR copy_skill_if_present apps/kiro-cli/skills/plannotator-annotate $KIRO_SKILLS_DIR # 核心知识 skill 没有 Kiro 专属形态其他 scope 装什么它就装什么 copy_skill_if_present apps/skills/core/plannotator $KIRO_SKILLS_DIR # 扩展 skills 来自 apps/skills/extra不在 apps/kiro-cli/skills 中重复 copy_skill_if_present apps/skills/extra/plannotator-setup-goal $KIRO_SKILLS_DIR copy_skill_if_present apps/skills/extra/plannotator-visual-explainer $KIRO_SKILLS_DIR # 自定义 agent —— 绝不覆盖用户已有的同名文件 if [ ! -f $HOME/.kiro/agents/plannotator.json ] [ -f apps/kiro-cli/agents/plannotator.json ]; then mkdir -p $HOME/.kiro/agents cp apps/kiro-cli/agents/plannotator.json $HOME/.kiro/agents/plannotator.json fi几个值得注意的安装行为agent 文件从不覆盖plannotator.json已存在时安装器直接跳过用户手工修改过的配置不会被冲掉核心知识 skill 也会装上除文档列出的 4 个 skill 外安装器还会复制 apps/skills/core/plannotator 这份 CLI 参考知识型skill源码注释说明这是为了让 Kiro 用户也拥有完整的命令参考支持显式退出安装安装器提供--skip-kiro参数对应环境变量PLANNOTATOR_SKIP_KIRO_INSTALL也可通过配置项skipInstall.kiro关闭见 scripts/install.sh 的帮助文本。退出安装时安装器对~/.kiro完全不写不删包括对陈旧 skill 的清理扫尾也会跳过 Kiro 目录。已安装的 Kiro Skills 详解Kiro 专属 skills带 origin 的命令形态两个 Kiro 专属 skill 都在命令中烤入了PLANNOTATOR_ORIGINkiro-cli这一点可以从各自的 SKILL.md 中直接看到。plannotator-review源码plannotator-review/SKILL.md——打开基于浏览器的代码评审 UI并处理返回的反馈# 基本用法评审当前改动git/jj diff PLANNOTATOR_ORIGINkiro-cli plannotator review # 附加一个 PR URL 进行评审 PLANNOTATOR_ORIGINkiro-cli plannotator review pr-url # 指定 base / diff 模式仅会话生效、仅 git 仓库可用 # 对堆叠分支--base 指向「你下面的那个分支」只评审本层 PLANNOTATOR_ORIGINkiro-cli plannotator review --base ref [--diff-type type]plannotator-annotate源码plannotator-annotate/SKILL.md——打开针对文件、文件夹或 URL 的批注 UI然后处理返回的批注PLANNOTATOR_ORIGINkiro-cli plannotator annotate $ARGUMENTS$ARGUMENTS应是一个 markdown/纯文本配置文件路径.md、.txt、.yaml、.json、.toml、.ini、.csv、.log等、文件夹路径、HTML 文件路径或 URL。SKILL.md 还要求如果命令报告参数无法解析为文件、URL 或文件夹模型应自行判断用户实际指的是哪个目标并用具体的路径或 URL 重新运行命令。两个 skill 的 frontmatter 都设置了disable-model-invocation: true意味着它们只能按需触发不会被模型自主唤起——这是「无后台钩子」设计在 skill 层面的具体体现。关于PLANNOTATOR_ORIGIN的作用边界它由服务端对照AGENT_CONFIG白名单校验见 packages/server/index.ts其中kiro-cli是合法取值之一。但对 Kiro 而言 origin 是纯装饰性的没有功能性影响。共享扩展 skills单一来源不重复维护plannotator-setup-goal把想法访谈成一个结构化的 goal 包plannotator-visual-explainer生成精致的自包含 HTML 可视化说明。这两个 skill 安装自 Plannotator 的规范目录 apps/skills/extra/不在 Kiro 包中复制副本。由于它们来自共享来源展示的是默认 agent 徽章而非 Kiro CLI——再次印证 origin 对 Kiro 只是装饰。使用 Plannotator 自定义 Agent安装器把 agent 写入~/.kiro/agents/plannotator.json。仓库中的规范版本是 agents/plannotator.json完整内容如下并逐字段说明{ name: plannotator, description: Kiro custom agent wiring for Plannotator review and annotation workflows., prompt: You run Plannotator, which opens a browser UI for human review and annotation. Choose the skill that matches the task:\n- plannotator-review: review the current code changes (git/jj diff) or a pull request before continuing; optionally pass a PR URL, or --base ref / --diff-type type to pin the sessions opening diff (git-only, session-only — e.g. --base the branch below yours for one layer of a stack).\n- plannotator-annotate: annotate a markdown or HTML file, a folder of docs, or a URL, then act on the returned annotations.\n- plannotator-setup-goal: turn an idea into a structured goal package by interviewing the user, building a fact sheet, then a plan.\n- plannotator-visual-explainer: generate a polished, self-contained HTML visual (implementation plan, PR walkthrough, or diagram) and open it for review.\nEach skill runs a plannotator shell command. plannotator-review and plannotator-annotate set PLANNOTATOR_ORIGINkiro-cli., tools: [shell], allowedTools: [shell], toolsSettings: { shell: { allowedCommands: [plannotator .*] } }, resources: [ skill://.kiro/skills/plannotator-*/SKILL.md, skill://~/.kiro/skills/plannotator-*/SKILL.md ] }逐字段拆解字段作用prompt向模型明确「哪个任务该用哪个 skill」评审当前改动/PR 用plannotator-review批注文件、文件夹或 URL 用plannotator-annotate把想法变 goal 包用plannotator-setup-goal生成 HTML 可视化用plannotator-visual-explainer。prompt 中还带上了--base/--diff-type等进阶参数的用法说明tools/allowedTools只授予shell工具toolsSettings.shell.allowedCommands用plannotator .*正则把 shell 权限收窄到 plannotator 命令agent 无法借 shell 执行任意命令resources通过skill://URI 把全部 Plannotator skills 挂进 agent.kiro/skills/匹配项目本地 skills~/.kiro/skills/匹配安装器写入的用户级 skills文档中给出的「skill → 用途」对照表Skill用途plannotator-review评审当前代码改动或一个 pull requestplannotator-annotate批注一个 markdown/HTML 文件、文件夹或 URLplannotator-setup-goal把一个想法转化为结构化的 goal 包plannotator-visual-explainer生成精致的可视化 HTML 说明启动 agentkiro-cli chat --agent plannotator复用 skills 构建自己的 agent如果你更喜欢自己的 agent把同样的skill://~/.kiro/skills/plannotator-*/SKILL.mdresources 加进任意自定义 agent 的resources列表即可复用全部四个 skill无需改动 skill 本身。前提与 Schema 注意事项自定义 agent 的 JSON 是刻意保守的因为 Kiro 的 schema 可能演变。如果你的 Kiro 版本对 resources 或工具权限期望不同的字段名直接编辑本机安装的~/.kiro/agents/plannotator.json适配你的运行时即可。这一保守姿态在仓库中有两处呼应其一apps/kiro-cli/README.md 专门设有 Schema note 一节提示若 Kiro 变更了 custom-agent schema 就修改已安装副本其二安装器在覆盖保护上同样保守——plannotator.json一旦存在就永不被安装器覆盖见 scripts/install.sh 中的if [ ! -f ... ]判断这保证了你手工适配后的字段修改在升级 Plannotator 后依然保留。赞分享【免费下载链接】plannotatorAnnotate and review coding agent plans and code diffs visually, share with your team, send feedback to agents with one click.项目地址https://gitcode.com/gh_mirrors/pl/plannotator点击查看免费下载相关推荐Plannotator 自定义反馈消息指南用 prompts 配置定制发送给 Agent 的 plan / annotate / review 反馈模板Plannotator 自定义反馈消息指南用 prompts 配置定制发送给 Agent 的 plan / annotate / review 反馈模板 PlStreamlit AI Agent Skills 安装实战深入解析 streamlit skills CLI 命令Streamlit AI Agent Skills 安装实战深入解析 streamlit skills CLI 命令 导读 Streamlit 从 v1.57数据可视化后端前端Plannotator Hook 集成用 --hook 把人工评审闸门嵌入 Agent 生命周期Plannotator Hook 集成用 hook 把人工评审闸门嵌入 Agent 生命周期 本篇基于 Plannotator 仓库中的官方指南 hook i上一篇如何快速上手Airports从JSON文件到全球机场信息查询的完整教程下一篇开源项目 extended_text 使用教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考