feat(spexcode-atlas): add SpexCode Atlas plugin - #10
Draft
shuxueshuxue wants to merge 1 commit into
Draft
Conversation
One skill, atlas, that reads a repository into a SpexCode spec tree, draws a checked diagram for each part worth one, and hands over the tree as a single browsable page; a whole repository runs as one dynamic workflow, turn by turn where CreateWorkflow is absent.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What / 改动内容
Adds SpexCode Atlas (
spexcode-atlas0.1.0, categorydeveloper-tools): one skill,atlas, that reads a repository into a SpexCode spec tree (.spec/, onespec.mdper part stating what it is for and which file it governs), draws a diagram for each part worth one, and hands over the whole tree as one self-contained HTML page that opens from disk.新增 SpexCode 图集(
spexcode-atlas0.1.0,分类developer-tools):一个 skillatlas,把代码仓库整理成 SpexCode 规格树,给值得配图的部分画图,最后交出一个直接从磁盘打开的单文件网页。skills/atlas/atlas.dwf.ts) withCreateWorkflow: survey, parallel spec writers, aspex spec lintgate, a planner, parallel cartographers each gated onspex diagram check, an independent reader whose findings are re-checked by separate subagents, then commit.spec/and publish the page as the run's artifact. Every check is aworld.runthe script branches on, never a subagent's claim.CreateWorkflow, the skill does the same job turn by turn and tells the user so.plugins/spexcode-atlas/(manifest, skill, workflow, README.md, README_CN.md),assets/spexcode-atlas/icon.png(256×256, transparent), and themarketplace.jsonentry.Dependencies and side effects (also in both READMEs): Node.js ≥ 22 and npm; SpexCode runs only through
npx -y -p spexcode@next spex …(downloads from the npm registry, no global install); writes.spec/in the current repository and commits it with.specas the only path; writesspexcode-atlas.htmlat the root, uncommitted; no MCP server, no hooks, no remote service, no telemetry. MIT, source: https://github.com/shuxueshuxue/spexcode.How it was tested / 测试方式
python3 scripts/validate.py→OK: 19 plugin(s) validated;python3 scripts/build_dist.py→plugins/spexcode-atlas/0.1.0/plugin.zip(13.8 KB);python3 -m unittest discover -s tests→ OK;git diff --checkclean.spexcode-atlas0.1.0 with no diagnostics;zcode pluginslists it enabled with 1 skill,zcode skills listlistsspexcode-atlas:atlas..spec/: 7 phases, 2 h 2 min, 39 subagents, GLM-5.2. Checked outside ZCode afterwards: two commits touching only.spec/, 39 nodes,spex spec lint0 errors, 21/21 diagrams passspex diagram check, the page opens from disk with no network requests. One node was skipped on purpose after its cartographer escalated and the main agent answered.Self-check / 自查清单
plugins/spexcode-atlas// 插件名唯一且 kebab-case,目录为plugins/spexcode-atlas/version0.1.0 in BOTHplugin.jsonandmarketplace.json/ 两处版本号一致README.md(EN) andREADME_CN.md(中文) both added and equivalent / 中英文 README 均已添加且语义一致description_i18nhas bothenandzh-CNpython3 scripts/validate.pyandpython3 scripts/build_dist.pypass locally / 本地校验与构建均通过Opened as a draft for the SpexCode maintainers' own review first. The whole-repository path needs a ZCode release that ships dynamic workflows; until then the skill's turn-by-turn path applies.