typo3-docs

分类: 文档与知识管理 | 上传者: netresearch | 下载: 0 | 版本: v1.0（最新）

在创建、编辑或审阅 TYPO3 扩展文档（Documentation/*.rst、guides.xml、README.md）、使用 Docker 渲染文档、使用 TYPO3 RST 指令、添加屏幕截图、部署到 docs.typo3.org、设置 TYPO3 文档 webhook、通过 Intercept 发布 TYPO3 文档、改进文档、添加屏幕截图、修复文档或文档准确性时使用。

更新日志: Source: GitHub https://github.com/netresearch/typo3-docs-skill

目录结构

当前层级: tree/main/skills/typo3-docs/

📁 assets/
- 📄 AGENTS.md 11.3 KB
📁 evals/
- 📄 evals.json 19.8 KB
📁 references/
- 📄 architecture-decision-records.md 10.1 KB
- 📄 asset-templates-guide.md 2.2 KB
- 📄 code-structure-elements.md 13.8 KB
- 📄 coding-guidelines.md 5.7 KB
- 📄 content-directives.md 11.1 KB
- 📄 documentation-coverage-analysis.md 10.1 KB
- 📄 extraction-patterns.md 24.1 KB
- 📄 file-structure.md 9.0 KB
- 📄 guides-xml.md 14.2 KB
- 📄 intercept-deployment.md 10.7 KB
- 📄 rendering.md 10.3 KB
- 📄 rst-syntax.md 13.1 KB
- 📄 screenshots.md 9.3 KB
- 📄 scripts-guide.md 1.1 KB
- 📄 text-roles-inline-code.md 7.3 KB
- 📄 typo3-directives.md 22.7 KB
- 📄 typo3-extension-architecture.md 16.2 KB
📁 scripts/
- 📄 add-agents-md.sh 2.0 KB
- 📄 analyze-docs.sh 11.7 KB
- 📄 check-adr-coverage.sh 625 B
- 📄 check-changelog-version-coverage.sh 880 B
- 📄 check-guides-xml-version-sync.sh 1.2 KB
- 📄 check-required-doc-sections.sh 1.5 KB
- 📄 check-rst-substitutions-used.sh 1.4 KB
- 📄 check-unreleased-versions.sh 537 B
- 📄 check-untranslated-fluid-strings.sh 1.6 KB
- 📄 check-version-match.sh 528 B
- 📄 extract-all.sh 4.1 KB
- 📄 extract-build-configs.sh 2.6 KB
- 📄 extract-composer.sh 1.6 KB
- 📄 extract-extension-config.sh 4.3 KB
- 📄 extract-php.sh 4.7 KB
- 📄 extract-project-files.sh 2.1 KB
- 📄 extract-repo-metadata.sh 4.3 KB
- 📄 render_docs.sh 977 B
- 📄 validate_docs.sh 4.1 KB
- 📄 validate_headings.py 4.1 KB
📄 checkpoints.yaml 13.4 KB
📄 SKILL.md 4.1 KB

SKILL.md

---
name: typo3-docs
description: "Use when creating, editing, or reviewing TYPO3 extension documentation (Documentation/*.rst, guides.xml, README.md), rendering docs with Docker, using TYPO3 RST directives, adding screenshots, deploying to docs.typo3.org, setting up TYPO3 docs webhook, publishing TYPO3 documentation via Intercept, improve docs, add screenshots, fix documentation, or docs accuracy."
license: "(MIT AND CC-BY-SA-4.0). See LICENSE-MIT and LICENSE-CC-BY-SA-4.0"
compatibility: "Requires php, docker (for rendering). TYPO3 extension with Documentation/ directory."
metadata:
  author: Netresearch DTT GmbH
  version: "2.12.0"
  repository: https://github.com/netresearch/typo3-docs-skill
allowed-tools: Bash(php:*) Bash(docker:*) Bash(sed:*) Bash(grep:*) Read Write Glob Grep
---

# TYPO3 Documentation Skill

Create and maintain TYPO3 extension documentation following official docs.typo3.org standards.

## Core Workflow

1. **Run extraction first** to identify documentation gaps:
   ```bash
   scripts/extract-all.sh /path/to/extension
   scripts/analyze-docs.sh /path/to/extension
   ```
2. Consult the appropriate reference file for the task
3. Use TYPO3-specific directives, not plain text
4. Validate: `scripts/validate_docs.sh /path/to/extension`
5. Render: `scripts/render_docs.sh /path/to/extension`

> **Critical**: When the user asks to "show docs", render and display HTML output, not raw RST.

## Element Selection Guide

| Content Type | Directive |
|--------------|-----------|
| Complete code | `literalinclude` (preferred over `code-block`) |
| Short snippets | `code-block` with `:caption:` |
| Config options | `confval` with `:name:`, `:type:`, `:default:` |
| PHP API | `php:method::` -- use `:returntype:` for nullable/union types |
| Notices | `note`, `tip`, `warning`, `important` |
| Feature grids | `card-grid` with `stretched-link` in footer |
| Alternatives | `tabs` (synchronized) |
| Screenshots | `figure` with `:zoom: lightbox` `:class: with-border with-shadow` |

## Critical Rules

- **UTF-8**, **4-space** indent, **80 char** line length, **LF** endings
- **CamelCase** file/directory names, **sentence case** headings
- **Permalink anchors** (`.. _label:`) before **every** section heading
- **Index.rst** required in every subdirectory
- **PNG** screenshots with `:alt:` and `:zoom: lightbox`
- **.editorconfig** required in `Documentation/`
- **Screenshots MANDATORY** for backend modules, config screens, UI workflows
- **Max 250 lines per RST page** -- split with `toctree` if exceeded
- **No `mailto:` links** -- use GitHub Issues/Discussions URLs
- **PHP domain**: never use `?Type` or `Type|null` in `php:method::` signatures; use `:returntype:` instead

## Code Example Validation

Cross-reference code examples against extension source:
grep method names in `Classes/`, compare CLI arguments against `configure()`,
verify API signatures match. See `references/extraction-patterns.md`.

## Pre-Commit Checklist

1. `.editorconfig` in `Documentation/`, `Index.rst` in every directory
2. 4-space indent, no tabs, max 80 chars
3. Code blocks have `:caption:`, inline code uses proper roles
4. Screenshots exist with `:alt:` and `:zoom: lightbox`
5. `scripts/validate_docs.sh` passes, render has no warnings
6. README and Documentation/ are synchronized

## References

- `references/file-structure.md` -- directory layout, naming conventions
- `references/guides-xml.md` -- build configuration, interlink settings
- `references/coding-guidelines.md` -- .editorconfig, indentation rules
- `references/rst-syntax.md` -- headings, lists, tables, formatting
- `references/text-roles-inline-code.md` -- `:php:`, `:file:`, `:guilabel:`, `:ref:`
- `references/code-structure-elements.md` -- code blocks, confval, PHP domain
- `references/typo3-directives.md` -- confval, versionadded, deprecated
- `references/content-directives.md` -- accordion, tabs, card-grid
- `references/screenshots.md` -- image requirements, figure directives
- `references/rendering.md` -- Docker commands, live preview
- `references/intercept-deployment.md` -- webhook, build triggers
- `references/asset-templates-guide.md` -- templates, screenshot workflow

登录后下载/点赞/收藏 ❤ 6 | ★ 0

typo3-docs

目录结构

SKILL.md

举报内容

提示