概述

firm-delivery-export

Converts firm workflow output into real deliverables in team tooling.

Supported formats

Format	Target	Required env
---	---	---
`github_pr`	GitHub repository PR	`GITHUB_TOKEN`
`jira_ticket`	Jira issue	`JIRA_API_TOKEN` + `JIRA_BASE_URL`
`linear_issue`	Linear issue	`LINEAR_API_KEY`
`markdown_report`	Local file / chat	none
`structured_document`	Markdown with frontmatter	none
`project_brief`	Structured PDF-ready doc	none
`slack_digest`	Slack message via webhook	`SLACK_WEBHOOK_URL`

Usage (after firm-orchestration run)

Use firm-delivery-export to publish last workflow result as a GitHub PR:
  repo: "myorg/myrepo"
  branch: "ai/sprint-24-plan"
  title: "feat: Sprint 24 plan (AI-generated, human review pending)"
  reviewers: ["@john", "@sarah"]

GitHub PR output schema

{
  "format": "github_pr",
  "repo": "org/repo",
  "branch": "ai/{kebab-objective}",
  "base": "main",
  "title": "...",
  "body": "## AI-generated delivery\n\n{merged_output}\n\n---\n_Generated by firm-orchestration_",
  "draft": true,
  "reviewers": [],
  "labels": ["ai-generated", "needs-review"]
}

Jira ticket output schema

{
  "format": "jira_ticket",
  "project": "ENG",
  "issue_type": "Story",
  "summary": "...",
  "description": "{merged_output}",
  "priority": "Medium",
  "labels": ["ai-generated"],
  "components": []
}

Security notes

GITHUB_TOKEN must have repo scope — use fine-grained tokens scoped to target repo
All PRs are created as drafts by default (draft: true) — never auto-merged
Human review is mandatory: a needs-review label is applied unconditionally
JIRA_API_TOKEN is never logged (masked in audit trail)
Slack webhook URLs are treated as secrets (masked in JSONL audit)

Error handling

Error	Behavior
---	---
API rate limit	Retry with exponential backoff (3 attempts, max 30s)
Auth failure	Fail fast, output error to session, never retry
Network timeout	Fallback to `markdown_report` format locally
Invalid schema	Reject with validation error listing missing fields

Example with delivery pipeline

1. Run firm-orchestration:
   objective: "Document the payment service API"
   departments: ["engineering", "operations"]
   delivery_format: "github_pr"

2. Run firm-delivery-export automatically:
   → Creates draft PR "docs: Payment service API documentation"
   → Branch: ai/document-payment-service-api
   → Labels: ai-generated, needs-review, documentation
   → Assigns to @team-engineering for review

💎 Support

Si ce skill vous est utile, vous pouvez soutenir le développement :

Dogecoin : DQBggqFNWsRNTPb6kkiwppnMo1Hm8edfWq

版本历史

共 1 个版本

v1.0.0 当前

2026-03-30 05:59 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)