Kiro Steering, Agents & Skills

收录经过实际使用验证的 Kiro 配置：Steering 规则、自定义 Agent、Skill。可直接复制到本地使用。

一个项目一个目录，每个目录自带 README 和安装说明，互不依赖。

内容

项目	类型	做什么
code-reader-sonnet	Agent + Steering	只读代码阅读 Sub Agent，配一条强制路由规则。改代码之前先把代码读懂，隔离探索上下文。
kiro-log-reader	Skill	读本地日志和会话记录。查报错、工具失败、Sub Agent 调用、MCP 状态、credit 消耗、会话时间线，以及 CLI/TUI/LSP 故障。
langfuse-session-export	Hook	Stop Hook，每轮对话结束后导出到 Langfuse，一轮一条 trace，带 reasoning、工具调用和成本。
long-file-edit	Steering	长文件分段写入、禁止 heredoc、路径限制在 workspace 内。绕开会导致超时和卡死的写法。
bilingual-translation	Agent + Steering	主要 Agent 默认使用英语进行规划和起草；所有面向用户的回复、进度更新以及中文文档，都会由 GPT 驱动的翻译 Agent 转换为自然的中文。
session-loader	Agent + PyPI CLI	在隔离上下文中加载会话日志的 Sub Agent：总结关键信息，将片段映射到行范围，并在会话或代码库上构建临时混合检索索引（词法 TF-IDF + 本地多语言语义嵌入，支持跨语言查询），在不占用上下文成本的情况下召回。支持两种会话格式；报告始终包含清理命令。

三者可以串起来：装完 code-reader-sonnet 之后，用 kiro-log-reader 的 subagents 子命令查委派是否真的发生了；langfuse-session-export 读的是同一份会话日志，但上传到 Langfuse 做长期留存和趋势分析，而 kiro-log-reader 只在本机分析、不外传。

目录约定

<project-name>/
├── README.md          这个项目做什么、怎么装
├── agents/            Agent 定义（JSON）   -> ~/.kiro/agents/
├── steering/          Steering 规则（MD）  -> ~/.kiro/steering/
├── skills/            Skill 目录           -> ~/.kiro/skills/
└── hooks/             Hook 定义（JSON）    -> ~/.kiro/hooks/

只放该项目用到的子目录。安装就是把对应子目录的内容拷到 ~/.kiro/ 下同名目录（全局生效），或拷到 <project>/.kiro/ 下（只对该项目生效）。具体命令看各项目的 README。

四种配置的区别

	加载/触发时机	适合放什么
Steering	每次对话注入，或按条件注入	短的、必须始终生效的约束
Agent	被主 Agent 委派时启动	需要独立上下文和独立权限的子任务
Skill	Agent 判断相关时才加载正文	长文档、专门知识、配套脚本
Hook	指定事件发生时自动执行	不需要 Agent 判断、该发生就发生的副作用

Steering 常驻上下文，所以要短。内容多的话用 Skill，正文只在触发后才占上下文。

Steering 的加载方式由 front matter 控制：

配置	行为
inclusion: always	每次对话都注入（默认）
inclusion: fileMatch + fileMatchPattern	匹配到指定文件时注入
inclusion: manual	仅在 chat 中用 # 手动引用时注入

贡献

新增一个目录，写好该目录的 README（做什么、怎么装、什么情况下不适用、需要配套哪些文件），然后在上面的「内容」表格加一行。

License

MIT