菜单
Use when syncing designs to GitHub issues or managing project boards. Trigger with GitHub integration or issue sync request.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when decomposing systems into modules with clear boundaries. Trigger with modularization or module boundary request. Loaded by ai-maestro-architect-agent-main-agent
Use when designing architectures, identifying risks, creating roadmaps, or breaking work into tasks. Trigger with planning or architecture design request. Loaded by ai-maestro-architect-agent-main-agent
Use when managing requirements, initializing plans, or approving transitions. Trigger with requirements analysis or plan initialization request. Loaded by ai-maestro-architect-agent-main-agent
Use when recording stack choices, constraints, or managing handoffs. Trigger with session memory ops request. Loaded by ai-maestro-architect-agent-main-agent
Use when persisting decisions, patterns, and constraints across sessions. Trigger with session memory or handoff request. Loaded by ai-maestro-architect-agent-main-agent
Use when managing design document states or lifecycle transitions. Trigger with design lifecycle or state transition request. Loaded by ai-maestro-architect-agent-main-agent
| name | amaa-github-integration |
| description | Use when syncing designs to GitHub issues or managing project boards. Trigger with GitHub integration or issue sync request. |
| context | fork |
| agent | ai-maestro-architect-agent-main-agent |
| user-invocable | true |
Link design documents to GitHub issues for complete traceability. Create issues from designs, attach designs to existing issues, and keep status synchronized between design document status and GitHub issue labels.
gh auth status)gh auth statuspython scripts/amaa_github_issue_create.py --uuid <UUID>python scripts/amaa_github_attach_document.py --uuid <UUID> --issue <N>python scripts/amaa_github_sync_status.py --uuid <UUID>--dry-run flag on create to preview before executing--all flag on sync scriptCopy this checklist and track your progress:
--dry-run flag to preview before executing| Document | Description |
|---|---|
| op-create-issue-from-design.md | When to Use, Prerequisites, Procedure, Checklist, Examples, Error Handling, Related Operations |
| op-attach-design-to-issue.md | When to Use, Prerequisites, Procedure, Checklist, Examples, Error Handling, Related Operations |
| op-sync-status-to-github.md | When to Use, Prerequisites, Procedure, Checklist, Examples, Status to Label Mapping, Error Handling, Related Operations |
| op-monitor-github-project.md | When to Use, Prerequisites, Procedure, [TIMESTAMP], Checklist, Examples, What to Monitor, Error Handling, Related Operations |
| op-generate-design-uuid.md | When to Use, Prerequisites, Procedure, Checklist, Examples, UUID Format, Error Handling, Related Operations |
# Create issue from design (dry-run first)
python scripts/amaa_github_issue_create.py --uuid PROJ-SPEC-20250129-a1b2c3d4 --dry-run
python scripts/amaa_github_issue_create.py --uuid PROJ-SPEC-20250129-a1b2c3d4
# Output: CREATED: https://github.com/owner/repo/issues/123
| Error | Cause | Solution |
|---|---|---|
| gh CLI not found | Not installed | brew install gh |
| gh not authenticated | No auth token | gh auth login |
| Document has no UUID | Missing frontmatter | Run amaa_design_uuid.py |
| Issue already exists | Duplicate attempt | Use attach or sync instead |
| Label creation failed | Missing permissions | Create labels manually |
| Operation | Output |
|---|---|
| Create Issue | GitHub issue URL + design frontmatter updated with related_issues |
| Attach Design | Comment posted on issue + labels updated |
| Sync Status | Old status label removed, new label added |
| Dry Run | Preview of what would happen without changes |
See Reference Documents table above.