一个新的 Workflow：工程师

[bestony]

创建一个新的 Workflow 文件。名称是 engineer.yml

功能是

1. 检查当前是否有未完成的 PLAN（在 plans）文件夹里；
2. 如果有，就分析里面的任务是否已经完成；如果没有，则结束
3. 分析如果任务没有完成，则调用 codex action 来进行任务的完成；
4. 完成任务后，自动创建对应的 PR 去提交。
5. 这个 Workflow 同一时间只支持一个，避免不同之间的 engineer 做相同的工作。
6. 状态只遵循 FrontMatter 中的 status 字段。

在 Plan 的 markdown 文件里提供 FrontMatter；至少包含 status 字段，该字段支持 TODO,DOING,DONE 三个字段。

[github-actions]

@bestony 当前需求分析中存在待确认问题，请在本 Issue 回复：

1. codex action 的具体调用方式与参数格式是否已有约定？

来源文档：plans/1-workflow.md

[bestony]

codex action 的具体调用方式采用 Github Actions 的方式调用；
这是一个参考

name: Perform a code review when a pull request is created.
on:
  pull_request:
    types: [opened]

jobs:
  codex:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    outputs:
      final_message: ${{ steps.run_codex.outputs.final-message }}
    steps:
      - uses: actions/checkout@v5
        with:
          # Explicitly check out the PR's merge commit.
          ref: refs/pull/${{ github.event.pull_request.number }}/merge

      - name: Pre-fetch base and head refs for the PR
        run: |
          git fetch --no-tags origin \
            ${{ github.event.pull_request.base.ref }} \
            +refs/pull/${{ github.event.pull_request.number }}/head

      # If you want Codex to build and run code, install any dependencies that
      # need to be downloaded before the "Run Codex" step because Codex's
      # default sandbox disables network access.

      - name: Run Codex
        id: run_codex
        uses: openai/codex-action@v1
        with:
          openai-api-key: ${{ secrets.OPENAI_API_KEY }}
          prompt: |
            This is PR #${{ github.event.pull_request.number }} for ${{ github.repository }}.

            Review ONLY the changes introduced by the PR, so consider:
               git log --oneline ${{ github.event.pull_request.base.sha }}...${{ github.event.pull_request.head.sha }}

            Suggest any improvements, potential bugs, or issues.
            Be concise and specific in your feedback.

            Pull request title and body:
            ----
            ${{ github.event.pull_request.title }}
            ${{ github.event.pull_request.body }}

  post_feedback:
    runs-on: ubuntu-latest
    needs: codex
    if: needs.codex.outputs.final_message != ''
    permissions:
      issues: write
      pull-requests: write
    steps:
      - name: Report Codex feedback
        uses: actions/github-script@v7
        env:
          CODEX_FINAL_MESSAGE: ${{ needs.codex.outputs.final_message }}
        with:
          github-token: ${{ github.token }}
          script: |
            await github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.payload.pull_request.number,
              body: process.env.CODEX_FINAL_MESSAGE,
            });

[bestony]

这个 Workflow 的触发应该是通过定时任务，每小时执行一次。

[bestony]

Plan 文件 FrontMatter 允许其他字段；不做字段检查。

[github-actions]

@bestony 当前需求分析中存在待确认问题，请在本 Issue 回复：

1. 当 plans/ 中存在多个 TODO/DOING 计划时，处理顺序与挑选规则是什么（按文件名、时间、或全部处理）？

来源文档：plans/1-workflow.md

[bestony]

当 plans/ 中存在多个 TODO/DOING 计划时，处理顺序与挑选规则是什么？

答案：按照序号顺序处理即可；

[github-actions]

@bestony 当前需求分析中存在待确认问题，请在本 Issue 回复：

1. 任务“已完成”的具体判定规则是什么（例如基于文件内容、PR 是否已存在等）？

来源文档：plans/1-workflow.md

[bestony]

@bestony 当前需求分析中存在待确认问题，请在本 Issue 回复：

1. 任务“已完成”的具体判定规则是什么（例如基于文件内容、PR 是否已存在等）？

来源文档：plans/1-workflow.md

基于 frontmatter 里的 status 字段。当字段为 DONE 时，表示已经完成。

[github-actions]

@bestony 当前需求分析中存在待确认问题，请在本 Issue 回复：

1. 当 Plan 文件缺少 status 字段时，是否视为 TODO 处理，还是直接跳过？

来源文档：plans/1-workflow.md

[bestony]

@bestony 当前需求分析中存在待确认问题，请在本 Issue 回复：

1. 当 Plan 文件缺少 status 字段时，是否视为 TODO 处理，还是直接跳过？

来源文档：plans/1-workflow.md

视为 TODO 处理；

[bestony]

还有什么待确认的问题么？如果有，请回复。

[github-actions]

@bestony 当前需求分析中存在待确认问题，请在本 Issue 回复：

1. 暂无（用户在 2026-02-20 询问是否还有待确认问题，当前未新增）。

来源文档：plans/1-workflow.md