菜单
Update CATALOG.md incrementally from a deployed ticket. Appends new files_created entries without regenerating entire catalog.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Merges bookend agent reports into revised readiness, complexity, and decomposition plan. Produces the final evidence-backed assessment consumed by sprint-architect-agent.
Fast filesystem readiness scan — counts docs, source files, manifests, platform signals. Produces initial ReadinessReport for agent spawning decisions.
Scores proposal complexity against codebase surface. Uses proposal text analysis and readiness stats to determine decomposition tier and agent count.
Generation-time design taste for web UI work. Anti-cliche bans, layout and motion hard rules, and client-intent dials. Advisory only - shapes drafts; declared measured contracts remain the sole gate authority.
Rigorously reasons about definitions, proofs, and computations in algebra, analysis, discrete math, probability, linear algebra, and applied math. Verifies derivations, spots invalid steps, and states assumptions clearly. Use when solving or proving math problems, reviewing mathematical arguments, modeling with equations, interpreting statistics, or when the user mentions proofs, lemmas, theorems, integrals, series, matrices, optimization, or numerical methods.
Visual verification for interactive elements (popups, modals, tooltips). Clicks elements and captures screenshots for analysis. Bypasses MCP browser tool limitations with cross-origin CSS.
| name | catalog-update |
| description | Update CATALOG.md incrementally from a deployed ticket. Appends new files_created entries without regenerating entire catalog. |
Updates CATALOG.md with files from a single deployed ticket. Faster than full regeneration when processing tickets one at a time.
{
"project_dir": "/path/to/project",
"ticket_path": "/path/to/deployed/ticket.json",
"catalog_path": "src/CATALOG.md"
}
# Read ticket JSON
cat "$ticket_path" | jq '.files_created'
{
"files_created": [
{
"path": "src/components/MetricCard.js",
"type": "component",
"intended_use": "Import { MetricCard } from './MetricCard.js'"
}
]
}
# Load current catalog
cat "$project_dir/$catalog_path"
For each file in files_created:
## Changelog
- **2026-01-07**: Added MetricCard component via TICKET-OXY-003-A.3
{
"skill": "catalog-update",
"status": "success|skipped|failure",
"ticket_id": "TICKET-OXY-003-A.3",
"files_added": 2,
"files_skipped": 1,
"categories_updated": ["Components", "Styles"],
"catalog_path": "src/CATALOG.md",
"changes": [
{
"action": "added",
"file": "src/components/impact/MetricCard.js",
"category": "Components"
},
{
"action": "skipped",
"file": "src/data/metrics.json",
"reason": "already_exists"
}
],
"errors": [],
"next_action": "proceed"
}
Ticket has files_created?
NO → status: "skipped", reason: "no files_created"
CATALOG.md exists?
NO → Create new catalog with ticket files
YES → Append to existing catalog
All files already in catalog?
YES → status: "skipped", reason: "all_duplicates"
NO → status: "success", files_added: N
Update after single ticket deployment:
{
"project_dir": "/projects/oxygen_site",
"ticket_path": "/projects/oxygen_site/tickets/sprint_current/deployed/TICKET-OXY-003-A.3.json",
"catalog_path": "src/CATALOG.md"
}
Custom catalog location:
{
"project_dir": "/projects/api-service",
"ticket_path": "/projects/api-service/tickets/deployed/TICKET-API-001.json",
"catalog_path": "docs/CATALOG.md"
}
| Aspect | catalog-update | generate-catalog |
|---|---|---|
| Scope | Single ticket | All deployed tickets |
| Speed | Fast (~1-2s) | Slower (~5-10s) |
| Use case | Post-deployment hook | Full rebuild |
| Duplicates | Skips existing | Overwrites all |