القائمة
Generate human-readable report from Intent files. Converts technical Intent specs into readable documents for stakeholders, team members, or documentation. Supports multiple output formats.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Scan and normalize existing intent/planning files to IDD standard. Auto-fixes mechanical issues (frontmatter, directory structure), tags content issues for pickup. Use /intent-normalize to scan current project, or /intent-normalize <path> for specific directory.
Critical review of Intent design quality. Checks for over-engineering, YAGNI violations, premature abstraction, and simplification opportunities. Uses interactive discussion to refine design decisions.
Transform vague ideas into implementation-ready specifications through structured interviewing. Use when user describes a new feature/product idea, has a problem to solve, or needs to document requirements. Two-phase process: Phase A produces decisions.md, Phase B composes INTENT.md under budget constraints.
Transform approved Intent into executable phased plan with strict TDD. Each step requires tests first (happy/bad/edge/security cases), then implementation. Use after /intent-review when ready to start development.
Start implementation from Intent. Validates Intent completeness, then either delegates to TaskSwarm (if available) or executes TDD phases directly. Use when you have an Intent ready and want to start building.
Manage structured change proposals for design documents with PR-like review experience. Use /intent-changes start <file> to begin, /intent-changes propose to suggest changes, /intent-changes accept/reject to decide, /intent-changes finalize to apply.
| name | intent-report |
| description | Generate human-readable report from Intent files. Converts technical Intent specs into readable documents for stakeholders, team members, or documentation. Supports multiple output formats. |
将技术性的 Intent 文件转换成人类可读的报告文档。
/intent-report [options]
↓
┌───────────────────────────────────┐
│ 读取 Intent 文件 │
│ - 项目级 + 模块级 │
│ - 解析结构和元数据 │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ 确定报告类型 │
│ - overview / architecture / │
│ progress / full │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ 生成报告 │
│ - 重组内容结构 │
│ - 转换技术语言 │
│ - 添加可视化 │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ 输出 │
│ - Markdown / HTML / PDF │
│ - 写入文件 or 直接展示 │
└───────────────────────────────────┘
/intent-report --type overview
一页纸项目概览，适合快速了解：
# [Project] Overview
## What is this?
[一句话说明]
## Problem
[要解决的问题]
## Solution
[解决方案概述]
## Architecture
[简化的架构图]
## Key Modules
| Module | Purpose |
|--------|---------|
## Status
[当前状态和下一步]
/intent-report --type architecture
详细架构文档，适合技术评审：
# [Project] Architecture
## System Overview
[架构图]
## Module Dependencies
[依赖关系图]
## Data Flow
[数据流图]
## Key Design Decisions
| Decision | Choice | Rationale |
## Boundary Rules
[模块边界规则]
## API Reference
[核心 API 列表]
/intent-report --type progress
项目进度报告，适合汇报：
# [Project] Progress Report
> Generated: YYYY-MM-DD
## Intent Coverage
[覆盖率图表]
## Module Status
| Module | Intent | Impl | Status |
|--------|--------|------|--------|
| core | ✓ | 80% | 🟡 |
## Recent Updates
[最近的 Intent 变更]
## Approval Status
- Locked: N sections
- Reviewed: M sections
- Draft: K sections
## Blockers & Risks
[风险和阻塞项]
## Next Steps
[下一步计划]
/intent-report --type full
完整技术文档，包含所有内容。
/intent-report -o report.md
/intent-report --format html -o report.html
带样式的 HTML 文档，可直接在浏览器查看。
/intent-report
不指定输出文件时，直接在终端展示。
/intent-report --type overview
/intent-report --type architecture -o docs/ARCHITECTURE.md
/intent-report --type progress -o reports/progress-2026-01.md
/intent-report src/core/ --type full
| Intent 中 | 报告中 |
|---|---|
## 职责 | "What this module does" |
## 非目标 | "Out of scope" |
## 约束 | "Constraints & Rules" |
::: locked | "Core Architecture (frozen)" |
::: reviewed | "Approved Design" |
::: draft | "Work in Progress" |
--mermaid 选项）/intent-init # 初始化
↓
/intent-interview # 创建 Intent
↓
/intent-review # 审批
↓
/intent-report # ← 生成报告（本命令）
↓
分享给 stakeholder / 团队
/intent-report
--type <type> # overview | architecture | progress | full
--format <format> # markdown | html
--output <path> # 输出文件路径
--module <path> # 指定模块
--include-draft # 包含 draft sections
--mermaid # 转换为 Mermaid 图
--lang <lang> # 输出语言 (en | zh)