Menu
Plan for adding temporary ID support to safe output jobs
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/az9713/gh-aw --skill temporary-id-safe-outputThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
Based on SOC occupation classification
| name | temporary-id-safe-output |
| description | Plan for adding temporary ID support to safe output jobs |
This document outlines the implementation plan for adding temporary ID support to safe output jobs. Temporary IDs allow agents to reference newly created issues within the same workflow run before they have actual GitHub issue numbers.
When an agent needs to create a parent issue and immediately link sub-issues to it in the same workflow run, the agent doesn't know the actual issue number until the create_issue job completes. Temporary IDs bridge this gap by allowing the agent to use placeholder IDs that are resolved to actual issue numbers at execution time.
Temporary IDs follow the pattern aw_[A-Za-z0-9]{3,8} where:
aw_ is a fixed prefix identifying agentic workflow temporary IDsXXXXXXXX is a 3-8 character alphanumeric string (A-Za-z0-9)Example: aw_abc, aw_abc123, aw_Test123
temporary_id.cjsLocation: pkg/workflow/js/temporary_id.cjs
This module provides shared utilities for temporary ID handling:
// Core functions
generateTemporaryId() // Generate new temporary ID
isTemporaryId(value) // Check if value is a temporary ID
normalizeTemporaryId(tempId) // Normalize to lowercase for map lookups
()
(value, map)
(text, map)
create_issueThe create_issue job outputs a temporary ID map that other jobs can consume:
Go changes (pkg/workflow/create_issue.go):
temporary_id_mapJavaScript changes (pkg/workflow/js/create_issue.cjs):
temporary_id -> issue_numbercore.setOutput("temporary_id_map", JSON.stringify(map))For each safe output job that needs to resolve temporary IDs:
In pkg/workflow/<job_name>.go:
createIssueJobName parameter to the build function:func (c *Compiler) build<JobName>Job(data *WorkflowData, mainJobName string, createIssueJobName string) (*Job, error) {
if createIssueJobName != "" {
customEnvVars = append(customEnvVars, fmt.Sprintf(" GH_AW_TEMPORARY_ID_MAP: ${{ needs.%s.outputs.temporary_id_map }}\n", createIssueJobName))
}
create_issue to the job's needs array:needs := []string{mainJobName}
if createIssueJobName != "" {
needs = append(needs, createIssueJobName)
}
SafeOutputJobConfig to use the dynamic needs:return c.buildSafeOutputJob(data, SafeOutputJobConfig{
// ...
Needs: needs,
// ...
})
In pkg/workflow/compiler_jobs.go:
Pass the createIssueJobName when building the job:
job, err := c.build<JobName>Job(data, mainJobName, createIssueJobName)
In pkg/workflow/js/<job_name>.cjs:
const { loadTemporaryIdMap, resolveIssueNumber } = require("./temporary_id.cjs");
const temporaryIdMap = loadTemporaryIdMap();
if (temporaryIdMap.size > 0) {
core.info(`Loaded temporary ID map with ${temporaryIdMap.size} entries`);
}
resolveIssueNumber() to resolve issue numbers:const resolved = resolveIssueNumber(item.issue_number, temporaryIdMap);
if (resolved.errorMessage) {
core.warning(`Failed to resolve issue: ${resolved.errorMessage}`);
continue;
}
const issueNumber = resolved.resolved;
if (resolved.wasTemporaryId) {
core.info(`Resolved temporary ID '${item.issue_number}' to issue #${issueNumber}`);
}
In pkg/workflow/js/collect_ndjson_output.cjs:
Add validation for fields that accept temporary IDs:
function isValidIssueNumberOrTemporaryId(value) {
if (typeof value === "number" && Number.isInteger(value) && value > 0) {
return true;
}
if (typeof value === "string" && /^aw_[0-9a-f]{12}$/i.test(value)) {
return true;
}
return false;
}
Use this validation for fields like parent_issue_number, sub_issue_number, etc.
When temporary ID resolution fails, the job should:
core.warning() instead of failing with core.setFailed()This ensures that:
safe-outputs:
create-issue:
title-prefix: "[Parent] "
labels: [tracking]
max: 3
link-sub-issue:
max: 10
{"type": "create_issue", "temporary_id": "aw_abc123", "title": "Parent: Feature X", "body": "..."}
{"type": "link_sub_issue", "parent_issue_number": "aw_abc123", "sub_issue_number": 42}
{"type": "link_sub_issue", "parent_issue_number": "aw_abc123", "sub_issue_number": 43}
main job: Agent generates output with temporary ID aw_abc123create_issue job: Creates issue #100, outputs {"aw_abc123": 100}link_sub_issue job:
aw_abc123 → 100| Job | Field(s) | Status |
|---|---|---|
link_sub_issue | parent_issue_number, sub_issue_number | ✅ Implemented |
add_comment | issue_number (via text replacement) | ✅ Implemented |
update_issue | issue_number | 🔄 Can be added |
close_pull_request | - | N/A (uses PR numbers) |
Add tests in pkg/workflow/js/temporary_id.test.cjs for:
isTemporaryId() with valid and invalid inputsresolveIssueNumber() with temporary IDs and regular numbersloadTemporaryIdMap() with various JSON inputsAdd tests in pkg/workflow/<job_name>_dependencies_test.go to verify:
create_issue in needs when configuredGH_AW_TEMPORARY_ID_MAP env var is set correctlycreate_issue dependencycreateIssueJobName parameterGH_AW_TEMPORARY_ID_MAP environment variablecreate_issue conditionallycreateIssueJobNameresolveIssueNumber() for issue number fieldscollect_ndjson_output.cjs if needed