mcpField
A
agent-navigation-sop

agent-navigation-sop

github.com/igorwarzochaAgent 工作流122101 次安装38 周前更新
代码仓库

关于 agent-navigation-sop

agent-navigation-sop 是一项 Agent 技能，用于编写补充 `/init` 的开发者向 AGENTS.md。它优先整理一次性验证命令、仓库限制、编码模式和任务路径。

主要功能

  1. 01列出一次性构建与测试命令
  2. 02排除阻塞和监视进程
  3. 03记录仓库特定限制
  4. 04将任务对应到目录和测试
  5. 05引用嵌套 AGENTS.md 文件

适用场景

  1. 01创建面向开发者的仓库指引
  2. 02记录安全的验证命令
  3. 03指引功能开发和缺陷修复

安装

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

$npx skills add https://github.com/igorwarzocha/opencode-workflows --skill agent-navigation-sop

安装后在 Claude Code 中输入/agent-navigation-sop确认已加载。

详细介绍

Agent 导航 SOP

本 SOP 通过为面向开发者的 AGENTS.md 文件提供深入映射，补充 /init 命令。

## 阶段 1：深入分析 Agent SHOULD 跳过基本目录扫描（opencode 已能查看目录树），并重点关注：
  1. 工具与脚本：找出用于构建、测试、Lint 和类型检查的一次性命令。
  2. 流程限制：找出应排除的开发服务器和监视模式。
  3. 约定：找出项目特有的命名方式、架构模式和独特的错误处理方式。

阶段 2：编写 AGENTS.md

目标是生成约 50 行的高密度内容。

1. 构建与测试（指令）
  • 列出可直接复制粘贴的一次性命令。
  • MUST NOT 包含 dev、watch 或交互式命令。
2. 限制与模式（规则）
  • CRITICAL：Agent MUST 明确禁止运行会阻塞的进程（开发服务器、监视模式）。
  • 找出 Agent SHOULD NOT 修改的只读或受限路径。
  • 记录仓库特有的编码模式（例如，“使用 Bun API”“优先使用函数式写法而非类”）。
3. 任务路由（路由）
  • 将常见任务（添加功能、修复 bug）映射到特定目录及相关测试。
  • 通过引用嵌套的 AGENTS.md 文件来了解包级详情，而不是重复这些内容。
  • 找出重复性任务，并 SHOULD 建议使用 skill-creator 创建新技能，以扩展 Agent 的能力。
- Agent MUST NOT 重复环境元数据（日期、操作系统、绝对路径）。 - STRONGLY RECOMMENDED 输出长度约为 50 行。 - Agent MUST 使用 RFC 2119 关键词（MUST、MUST NOT、SHOULD、STRONGLY RECOMMENDED）。 - Agent MUST 优先说明“访问限制”（只读文件/文件夹）。 - Agent MUST NOT 记录长时间运行或会阻塞的进程。 - Agent MUST 记录一次性验证命令（构建、Lint、测试、类型检查、代码生成）。 - Agent MUST NOT 包含不会改变 Agent 行为的文字说明。

评论

支持 Markdown