Repository navigation
Done
Description
Summary
When a user installs the GitHub Agentic Workflows package (github/squad/workflows@534894c5d1702d20e71d49778c95764fba92f383 or b37155bef49c8e2ff6a211dfe71bda53157bc92f) and comments /squad cast on an issue, the workflow fails on the first attempt due to two separate bugs in workflows/squad.md (and workflows/package/squad.md):
-
SDK Session Skill Discovery Bug (
copilot-sdk: true):- Activation extracts the 28 inline skills (including
.github/skills/squad-cast/SKILL.md) and the Agent job restores them into${GITHUB_WORKSPACE}/.github/skills/. - However, when
copilot-sdk: trueis active, the defaultgh-awSDK driver connects to the headless Copilot CLI sidecar (127.0.0.1:3002) and callsclient.createSession(...)without passingworkingDirectoryorskillDirectories: [join(workspace, ".github", "skills")]. - As a result,
<available_skills>in the session system prompt only listscustomize-cloud-agentandgithub-pr-media. When the agent callsskill({ skill: "squad-cast" }), the tool returnsSkill not found: squad-cast, and the agent obeys the instruction not to improvise and halts withreport_incomplete.
- Activation extracts the 28 inline skills (including
-
Playbook vs. Deterministic Validator Schema Mismatch (
squad-castStep 3 vs.squad-cast-validator.mjs):- Even when the agent reads
.github/skills/squad-cast/SKILL.mddirectly from disk viabash, Step 3 item 5 of thesquad-castplaybook instructs the agent to write.squad/casting/history.jsonas:{ "universe_usage_history": [{ "universe": "descriptive-or-Universe", "assigned_at": "ISO", "agent_count": N }], "assignment_cast_snapshots": {} } - Meanwhile,
squad-cast-validator.mjs(validateCastingPairFiles) requires:universe_usage_historyentries to use"used_at"(rejecting"assigned_at"withregistry: universe usage history is malformed), andassignment_cast_snapshotsto be non-empty and contain a matching revision snapshot (e.g."cast-revision-1"withcreated_at === registry.generated_at,agents, anduniverse), without leftovertransaction_id/registry_revisionfields from the disposable activation preset when no commit manifest is present.
- Because
validateCastingPairFilesfails onhistory.json, the validator treats the active specialist set as empty (specialists=0), cascading into 20+ false-positive charter, routing, and payload errors.
- Even when the agent reads
Steps to Reproduce
- Install
github/squad/workflowsin a consumer repository withgh-awv0.91.5 and merge the installation tomain. - Open an issue describing the desired team scope and comment
/squad cast. - Observe run failure 1:
skill("squad-cast")fails withSkill not found: squad-castand the agent emitsreport_incomplete. - Instruct the agent to read
.github/skills/squad-cast/SKILL.mdfrom disk and retry/squad cast. - Observe run failure 2:
run-squad-cast-validatorexits1withregistry: universe usage history is malformedandcoordinator: capability counts must equal active/routing state (specialists=0, ...).
Proposed Fix
- Bind
workingDirectory: rootandskillDirectories: [join(root, ".github", "skills")]increateSessionwhen running undercopilot-sdk: true(or instruct Execute Mode insquad.mdto read.github/skills/<skill-name>/SKILL.mddirectly from disk whenskill()is not registered in the headless SDK session). - Update Step 3 item 5 of the
squad-castplaybook inworkflows/squad.mdandworkflows/package/squad.mdso thehistory.jsonexample matchessquad-cast-validator.mjs(used_at,assignment_cast_snapshots["cast-revision-1"],revision: 1for a fresh Cast, and stripping disposable presettransaction_id/registry_revisionfields).
Metadata
Metadata
Assignees
Labels
No labels
Activity
fix(gh-aw): align squad-cast history.json playbook with validator and…