mcpField
O
orient

orient

github.com/camachoAgent 工作流646 次安装
代码仓库

关于 orient

orient 是用于任务启动的 Agent 技能，会收集任务背景、判断任务类型、检查项目决策和近期记忆，并生成简报与后续流程建议，适用于代码仓库中的任务准备。

主要功能

  1. 01在可用时获取 GitHub issue 详情
  2. 02判断任务类型并选择分支前缀
  3. 03扫描相关 ADR 决策
  4. 04检查中断工作和近期记忆
  5. 05生成任务简报与流程建议

适用场景

  1. 01根据 GitHub issue 启动工作
  2. 02根据任务描述准备分支计划
  3. 03使用保存的分支上下文恢复工作

安装

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

$npx skills add https://github.com/camacho/ai-skills --skill orient

安装后在 Claude Code 中输入/orient确认已加载。

详细介绍

阶段门：EXPLORE 检查点。在继续进入 Isolate 之前，此技能必须完成所有步骤。

步骤

  1. 获取问题上下文（如果提供了问题编号）：

    gh issue view <number> --json title,body,labels,assignees

    如果未提供问题编号，请让用户描述任务。 如果 gh 不可用（远程会话中没有 GH_TOKEN），则跳过问题获取，并根据手动描述继续。

  2. 自动检测任务类型（根据标签或描述）：

    标签 / 关键词类型分支前缀
    bug、错误、崩溃、损坏、修复Bug 修复fix/
    enhancement、功能、添加、想要、应该、新功能feat/
    chore、配置、依赖、ci、工具日常维护chore/
    docs、文档、readme文档docs/
    默认功能feat/

  3. 扫描相关 ADR：

    ls "$(git rev-parse --show-toplevel)/ai-workspace/decisions/"*.md 2>/dev/null | head -20

    检查 ADR 标题 / 文件名，查找与问题标题或正文中的关键词匹配的内容。如果找到匹配项，阅读相关 ADR 并将其纳入说明。 如果 ADR 扫描发现矛盾，请明确指出：“此任务可能与 ADR-NNN 冲突”

  4. 检查是否有中断的工作： 如果 "$(git rev-parse --show-toplevel)/.branch-context.md" 存在，请阅读并将其纳入简报（恢复工作）。

  5. 阅读近期记忆：

    tail -20 "$(git rev-parse --show-toplevel)/ai-workspace/MEMORY.md" 2>/dev/null

  6. 呈现简报：

    ## Orient Brief
**Task**: [title or description]
**Type**: [bugfix/feature/chore/docs] → branch prefix: [fix/feat/chore/docs]/
**Suggested branch**: [prefix]/[kebab-case-name]
**Relevant ADRs**: [list or "none found"]
**Resuming?**: [yes — from .branch-context.md / no]
**Files likely affected**: [educated guess from issue description + ADR context]

  7. 根据一句话规则自动路由：

    • 能否用一句话描述此任务的全部差异？→ 直接进入 Isolate（跳过 Design/Review）
    • 否则 → 先制定计划（Isolate 之后进入 Design）

    呈现路由决定。Agent 会自动决定，无需人工输入。如果有人类参与，他们可以更改决定。

边缘情况

  • 未提供问题编号且未提供用户描述 → 请用户描述任务
  • gh 不可用 → 跳过问题获取，根据手动描述继续
  • 没有 ADR 目录 → 跳过 ADR 扫描

评论

支持 Markdown