Skip to content

fix: address issues #7, #8, #9 (docs, user interaction, skill guidelines)#10

Merged
123pc merged 1 commit into
mainfrom
feature/修改issues
May 23, 2026

Hidden character warning

The head ref may contain hidden characters: "feature/\u4fee\u6539issues"
Merged

fix: address issues #7, #8, #9 (docs, user interaction, skill guidelines)#10
123pc merged 1 commit into
mainfrom
feature/修改issues

Conversation

@lijiawei255

@lijiawei255 lijiawei255 commented May 22, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • README文档架构图可读性优化 #7 README 架构图 SVG 化: 将 README.md 中的文本架构图替换为 Mermaid 生成的 SVG 图片,源码 docs/architecture.mmd 保留在版本控制中便于后续编辑
  • agent助手安装和使用时用户交互优化 #8 用户交互优化:
    • geogebra-setup 技能:安装前先用自然语言询问用户要配置哪个 agent(Claude Code / Codex / 两者)
    • geogebra-master 技能:绘图前询问用户使用在线 CDN 还是离线 bundle 模式
    • 修复步骤 4 桌面版指令与 Web Runtime 选择的矛盾(标注为 desktop-only)
  • 开发时避免测试集污染技能的小建议 #9 技能开发防污染准则: 在 AGENTS.md 添加 Skill Development Guidelines,防止技能对特定构造类型过拟合

Test plan

  • Python 测试全部通过(64 passed)
  • Node.js 测试全部通过(27 passed)
  • 在 Claude Code 中验证安装流程是否提示 agent 选择
  • 在 Claude Code 中验证绘图流程是否提示在线/离线选择
  • 在 GitHub 上确认 README 架构图 SVG 正常渲染

🤖 Generated with Claude Code

- #7: Replace text architecture diagram in README with Mermaid-generated SVG
- #8: Add user interaction prompts in skills (agent selection during setup,
  online/local mode before drawing); qualify desktop-only instructions
- #9: Add Skill Development Guidelines to AGENTS.md to prevent test-set
  pollution (construction-type-specific residue, cross-type verification,
  clean commits)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@lijiawei255

Copy link
Copy Markdown
Collaborator Author

@123pc 你好,此 PR 修复了仓库中 3 个开放的 issues:

请审核,谢谢!

@123pc 123pc left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed the changed docs and skill instructions. Verified the setup skill's new --agent flow matches scripts/setup_geogebra_mcp.py, checked the README architecture SVG reference and parsed docs/architecture.svg as valid XML, and ran the stated automated tests locally:

  • python -m pytest: 64 passed
  • npm test: 27 passed

The remaining manual checklist items are reasonable documentation/runtime checks, and I did not find blockers in the PR changes.

@123pc 123pc merged commit b1b6bbc into main May 23, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants