文档
- 作者仓库星标 0
- 作者仓库 nano-core
- 领域
- 文档
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @0-CYBERDYNE-SYSTEMS-0 · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- macOS
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Docs Skill - Professional Software Documentation Generator
## When to use this skill
- Use when the user request matches this skill's domain and capabilities.
- Use when this workflow or toolchain is explicitly requested.
## When not to use this skill
- Do not use when another skill is a better direct match for the task.
- Do not use when the request is outside this skill's scope.
Generate stunning, professional software documentation that elevates your projects above the competition. This skill implements a rigorous 4-phase process powered by AI models for maximum impact.
## Philosophy
This skill represents documentation excellence through:
1. **Rigorous Discovery** - Comprehensive project analysis leaving no detail unexplored
2. **Kimi K2.5 Thinking** - Advanced reasoning for optimal documentation architecture
3. **Gemini 3 Flash Design** - Modern, cutting-edge visual design generation
4. **Unique Positioning** - Documentation that differentiates your project
## Rigorous Research Routine
Before generating any documentation, the skill performs exhaustive investigation:
### Project Analysis
- Complete file tree traversal and categorization
- Language detection and version identification
- Dependency mapping and ecosystem analysis
- Architecture pattern recognition
- Code complexity and structure assessment
### Ecosystem Investigation
- Framework and library detection
- Database and service integrations
- API patterns and contract analysis
- Build tool and deployment configuration
- Testing infrastructure mapping
### Audience Research
- Target user persona analysis
- Use case pattern extraction
- Competitor documentation benchmarking
- Industry best practices integration
- SEO optimization for discoverability
### Competitive Analysis
- Feature comparison and differentiation
- Unique selling proposition extraction
- Documentation style benchmarking
- Visual design trend integration
## Kimi K2.5 Thinking Phase
The Kimi K2.5 model (via `kimi-code/kimi-for-coding`) powers deep reasoning for:
- **Documentation Architecture**: Optimal section structure and navigation
- **Content Strategy**: What to document, depth per section
- **Example Selection**: Best code snippets to showcase features
- **User Journey Mapping**: Logical flow from introduction to mastery
- **Gap Analysis**: Identifying undocumented areas
### Thinking Process Outputs
1. Documentation skeleton with prioritized sections
2. Key messages and value propositions
3. Recommended example scenarios
4. Audience-appropriate technical depth
5. SEO keywords and meta descriptions
## Gemini 3 Flash Design Phase
Gemini 3 Flash generates modern, production-ready documentation designs:
### Modern Design Features
- **Swiss/Brutalist** typography with strong grid alignment
- **Monospace metadata** blocks for AI agent parsing
- **Semantic structure** with clear hierarchy markers
- **Minimal color** - black, white, single accent
- **High contrast** - crisp edges, no blur effects
- **Structured data blocks** - JSON-LD ready, LLM-friendly
### Design Trends (2025)
- **Swiss precision** - grid systems, asymmetric balance
- **Brutalist clarity** - raw typography, high contrast
- **Monospace data** - machine-readable blocks
- **No gradients, no blur, no shadows**
- **One accent color** - maximum impact
- **Flowing prose** for humans, structured blocks for AI
## Usage
```bash
uv run {baseDir}/scripts/generate_docs.py --path "/path/to/project" --type "all"
```
## Output Types
| Type | Description | Best For |
|------|-------------|----------|
| `readme` | Comprehensive README with badges, setup, usage | GitHub repos |
| `api` | Complete API reference with examples | Libraries, SDKs |
| `guide` | User guides and tutorials | Onboarding, how-tos |
| `website` | Full static site (HTML/CSS/JS) | Documentation portals |
| `all` | Complete documentation suite | Full projects |
## Options
| Option | Description |
|--------|-------------|
| `--path, -p` | Project root path (required) |
| `--type, -t` | Documentation type: readme/api/guide/website/all |
| `--output, -o` | Output directory |
| `--theme` | Theme: brutalist/swiss/minimal/technical |
| `--title` | Project title (auto-detected if omitted) |
| `--tagline` | One-line description for hero section |
| `--audience` | Target: beginners/intermediate/experts |
| `--ai-think` | Enable Kimi K2.5 reasoning (default: auto) |
| `--ai-design` | Enable Gemini 3 Flash design (default: auto) |
## Examples
```bash
# Full documentation suite with AI enhancement
uv run {baseDir}/scripts/generate_docs.py -p ~/myproject -t all --ai-think --ai-design
# README only with brutalist theme
uv run {baseDir}/scripts/generate_docs.py -p ~/myproject -t readme --theme brutalist \
--title "SuperTool" --tagline "The ultimate solution for modern workflows"
# Complete website documentation with swiss theme
uv run {baseDir}/scripts/generate_docs.py -p ~/project -t website \
--audience experts --title "Enterprise SDK" --theme swiss
# API documentation with technical theme
uv run {baseDir}/scripts/generate_docs.py -p ~/library -t api --theme technical
```
## Model Configuration
Configure AI models for optimal performance:
```json
{
"skills": {
"docs": {
"thinkModel": "kimi-code/kimi-for-coding",
"designModel": "gemini-2.0-flash",
"features": {
"reasoning": true,
"designGeneration": true,
"seoOptimization": true,
"interactiveExamples": true
}
}
}
}
```
### Model Selection Guide
| Phase | Model | Purpose | When to Use |
|-------|-------|---------|-------------|
| Thinking | Kimi K2.5 | Architecture, structure, content strategy | Complex projects, unique requirements |
| Design | Gemini 3 Flash | Visual design, modern layouts | All projects (fast and capable) |
| Fallback | MiniMax-M2.1 | General generation | When specialized models unavailable |
## Best Practices Applied
Generated documentation includes:
### Content Excellence
- Compelling hero section with clear value proposition
- Quick start guide for immediate productivity
- Comprehensive examples with real-world scenarios
- API reference with parameter tables
- Troubleshooting and FAQ sections
- Contributing guidelines with workflow diagrams
### Visual Design
- Modern CSS with CSS custom properties
- Responsive grid layouts
- Accessible color schemes
- Print-friendly styles
- Syntax highlighting (via Prism.js ready structure)
- Copy-to-clipboard functionality
### SEO & Discovery
- Semantic HTML structure
- Meta description optimization
- Open Graph tags for social sharing
- Sitemap-ready structure
- Canonical URLs
- Structured data (JSON-LD ready)
### Performance
- Minimal CSS (under 10KB gzipped)
- No external dependencies (self-contained)
- Lazy loading for images
- Critical CSS inline
- Cache-friendly asset structure
## Integration Points
### GitHub Integration
- Shields.io badges ready
- Issue/PR templates auto-generated
- GitHub Pages deployment ready
- Actions workflow documentation
### CI/CD Integration
- Documentation build in pipelines
- Automated API doc generation
- Version-based doc branching
- Deploy preview support
## Troubleshooting
| Issue | Solution |
|-------|----------|
| Missing dependencies | Install: `uv pip install -r requirements.txt` |
| AI models unavailable | Fallback to template-based generation |
| Large projects | Use `--type readme` first, then expand |
| Custom themes | Place CSS in `docs/theme.css` for override |
## Performance Tips
1. **For large monorepos**: Generate docs per package with `--output`
2. **For frequent updates**: Use `--type api` for incremental API docs
3. **For release notes**: Generate CHANGELOG.md alongside docs
4. **For multi-language**: Generate docs per language with separate runs
章节与文件索引
按说明文件中的顺序排列。
何时使用该技能
什么时候不应该使用这个技能
理念
严格的研究程序
项目分析
文件/命令 -> kimi-code/kimi-for-coding · readme · guide · website · all · --path, -p · --type, -t · --output, -o
内容校验值 -> 2aeade673647
当前原文的自动摘译,尚未人工审校。
何时使用该技能
当用户请求与该技能的领域和功能匹配时使用。当明确请求此工作流程或工具链时使用。
什么时候不应该使用这个技能
当其他技能更适合该任务时,请勿使用。当请求超出该技能的范围时请勿使用。生成令人惊叹的专业软件文档,使您的项目在竞争中脱颖而出。该技能实施由 AI 模型支持的严格的 4 阶段流程,以实现最大影响。
理念
该技能通过以下方式代表卓越的文档编制: 严谨的发现 - 全面的项目分析,不留任何未探索的细节 Kimi K2.5 思考 - 最佳文档架构的高级推理 Gemini 3 Flash 设计 - 现代、尖端的视觉设计生成 独特的定位 - 使您的项目脱颖而出的文档
严格的研究程序
在生成任何文档之前,该技能会执行详尽的调查:
项目分析
完整的文件树遍历和分类 语言检测和版本识别 依赖关系映射和生态系统分析 架构模式识别 代码复杂性和结构评估