菜单
Generate CATALOG.md from deployed tickets. Extracts files_created metadata and builds project asset catalog with usage instructions.
用 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 | generate-catalog |
| description | Generate CATALOG.md from deployed tickets. Extracts files_created metadata and builds project asset catalog with usage instructions. |
Generates or updates CATALOG.md from deployed ticket metadata. Builds a comprehensive asset catalog showing all components, styles, and utilities with usage instructions.
{
"project_dir": "/path/to/project",
"tickets_dir": "/path/to/tickets/deployed",
"include_tests": false,
"include_deps": true
}
cd $tickets_dir
for ticket in *.json; do
jq -r '.files_created[]' "$ticket"
done
For each deployed ticket, extract:
{
"files_created": [
{
"path": "src/components/MetricCard.js",
"type": "component",
"intended_use": "Import { MetricCard } from './MetricCard.js'"
}
]
}
| Category | Patterns | Description |
|---|---|---|
| Components | src/components/**/*.js | Reusable UI components |
| Styles | src/styles/**/*.css | CSS stylesheets |
| Utils | src/utils/**/*.js, src/js/utils/** | Helper functions |
| Data | src/data/**/*.json | Static data files |
| Pages | src/pages/**/*.html | HTML pages |
| Tests | tests/**/*, *.spec.js | Test files (if included) |
# Project Asset Catalog
> Auto-generated by generate-catalog on {date}
## Summary
| Category | Count | Status |
|----------|-------|--------|
| Components | 5 | ✅ |
| Styles | 3 | ✅ |
## Components
| File | Intended Use | Created By |
|------|--------------|------------|
| `src/components/MetricCard.js` | Import { MetricCard } | TICKET-001 |
{
"skill": "generate-catalog",
"status": "success|failure",
"catalog_path": "src/CATALOG.md",
"stats": {
"tickets_processed": 5,
"files_cataloged": 23,
"categories": {
"components": 8,
"styles": 5,
"utils": 4,
"data": 2,
"pages": 4
}
},
"errors": [],
"warnings": [],
"next_action": "proceed"
}
# Project Asset Catalog
> Auto-generated by generate-catalog on 2026-01-07
## Summary
| Category | Count | Status |
|----------|-------|--------|
| Components | 8 | ✅ |
| Styles | 5 | ✅ |
| Utils | 4 | ✅ |
| Data | 2 | ✅ |
| **Total** | **19** | |
## Components
| File | Intended Use | Created By |
|------|--------------|------------|
| `src/components/impact/MetricCard.js` | Import { MetricCard } from './MetricCard.js' | TICKET-OXY-003-A.3 |
## Styles
| File | Intended Use | Created By |
|------|--------------|------------|
| `src/styles/components/metric-card.css` | Link in HTML: <link rel="stylesheet" href="..."> | TICKET-OXY-003-A.3 |
## Changelog
- **2026-01-07**: Added MetricCard component via TICKET-OXY-003-A.3
All tickets parsed successfully?
YES → status: "success"
NO → status: "failure", errors: [parse errors]
Catalog written successfully?
YES → next_action: "proceed"
NO → next_action: "fix"
Generate from deployed tickets:
{
"project_dir": "/projects/oxygen_site",
"tickets_dir": "/projects/oxygen_site/tickets/sprint_current/deployed",
"include_tests": false,
"include_deps": true
}
Include test files:
{
"project_dir": "/projects/oxygen_site",
"tickets_dir": "/projects/oxygen_site/tickets/sprint_current/deployed",
"include_tests": true,
"include_deps": true
}
Custom tickets directory:
{
"project_dir": "/projects/oxygen_site",
"tickets_dir": "/projects/oxygen_site/tickets/archive/sprint-42",
"include_tests": false,
"include_deps": false
}
When updating existing CATALOG.md: