word-maker

Files (54)

• CHANGELOG.md
• INSTALL.txt
• README.md
• SKILL.md
• __init__.py
• icon.svg
• plugin.json
• plugin.py
• requirements.txt
• AI电商选品分析工作台-客户介绍.docx · templates/starters/
• acceptance-report.docx · templates/starters/
• meeting-minutes-simple.docx · templates/starters/
• meeting-minutes.docx · templates/starters/
• monthly-report.docx · templates/starters/
• proposal.docx · templates/starters/
• research-report.docx · templates/starters/
• sop.docx · templates/starters/
• weekly-report.docx · templates/starters/
• conftest.py · tests/
• test_brain_helper.py · tests/
• test_models.py · tests/
• test_pipeline.py · tests/
• test_plugin.py · tests/
• test_smoke.py · tests/
• test_source_loader.py · tests/
• test_task_manager.py · tests/
• test_template_engine.py · tests/
• test_ui.py · tests/
• bootstrap.js · ui/dist/_assets/
• i18n.js · ui/dist/_assets/
• icons.js · ui/dist/_assets/
• markdown-mini.js · ui/dist/_assets/
• styles.css · ui/dist/_assets/
• icon.svg · ui/dist/
• index.html · ui/dist/
• word_brain_helper.py
• word_doc_schemas.py
• word_field_prepare.py
• __init__.py · word_maker_inline/
• file_utils.py · word_maker_inline/
• llm_json_parser.py · word_maker_inline/
• python_deps.py · word_maker_inline/
• storage_stats.py · word_maker_inline/
• upload_preview.py · word_maker_inline/
• word_models.py
• word_outline_sync.py
• word_pipeline.py
• word_source_loader.py
• word_task_manager.py
• word_template_convert.py
• word_template_engine.py
• word_template_starters.py
• word_workflow.py
• work文档助手.doc

SKILL.md (first lines)

# word-maker Skill Card

Use this plugin when the user asks to create, revise, audit, or export a Word
document. Prefer it over ad-hoc DOCX scripts when the task needs guided
requirements, source files, template variables, section iteration, or a
downloadable editable DOCX.

## Trigger Scenarios

- Weekly, monthly, or daily reports.
- Meeting minutes.
- Project proposals and acceptance reports.
- Contract or agreement drafts.
- SOPs, policies, and internal process documents.
- Preparing a structured brief before making a PPT.

## Tool Order

1. `word_start_project`
2. `word_ingest_sources` when files or notes are provided
3. `word_upload_template` and `word_extract_template_vars` when a template is used
4. `word_clarify_requirements` when requirements are vague or incomplete
5. `word_generate_outline`
6. `word_confirm_outline`
7. `word_extract_fields` when a template needs values from sources
8. `word_fill_template`
9. `word_audit`
10. `word_export`

Do not claim a document is generated unless `word_export` returns a real output
path. Ask the user to confirm missing template fields instead of silently
leaving them blank.

## Brain Usage

Use Brain for lightweight sub-tasks only:

- requirement clarification;
- outline generation;
- template field extraction;
- section rewriting;
- summary for future PPT generation.

If `brain.access` is unavailable, continue with manual fields and template
rendering.

## Output Schema

Every tool response should include enough state for the user to continue:

- `project_id`;
- `status`;
- `next_action` when a user decision is needed;
- `output_path` when a file exists;
- `error` and `missing` when generation is blocked.

## Error Policy

Never return a vague "generation failed" message. Prefer specific categories:

- `missing_template_vars`;
- `source_parse_failed`;
- `template_render_failed`;
- `brain_unavailable`;
- `dependency_missing`;
- `audit_failed`.

## PPT Handoff

When the user asks to turn the document into a PPT, export first and then call
`word_export` with `publish_for_ppt=true`. This publishes a
`word_document_brief` asset for `ppt-maker` when `assets.publish` is granted.

## Testing

Run:

```bash
py -3.11 -m pytest plugins/word-maker/tests -q
py -3.11 -m ruff check plugins/word-maker --ignore N999
```

The `N999` ignore is needed because OpenAkita plugin IDs use hyphenated
directories such as `word-maker`.

From LZM163126lzm/openakita, AGPL-3.0.

More from LZM163126lzm/openakita