Community生产力与协作github.com

Pu11en/sysmap

通过保存的可点击地图来规划和解释系统。适用于协作设计、延续规划对话、系统解释或准备实施方案。将设计问题保留在聊天中。

sysmap 是什么?

该技能帮助AI Agent用户通过结构化的系统地图进行协作设计、系统解释和规划实施。其核心思路是将讨论保留在聊天中,而系统行为通过一张可点击、可导航的地图来呈现,确保设计与实现分离,避免在规划阶段直接进入实现。该技能要求从已保存的 `.plan.json` 源文件开始,遵循严谨的规划指南,包括:基于证据记录每个部分的职责、输入、工作、结果和规则;区分已确认事实、未知项和未接受的提议;使用显式链接而非模糊猜测来连接子页面。它支持在 Claude Code、Cursor、Codex 等常见AI Agent平台上使用,通过本地文件系统和结构化标记维护规划状态,并通过构建和检查工具验证地图的连通性和语义一致性。最终,规划完成后会生成一份清晰的准备状态总结,供团队成员或AI继续执行。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pu11en/sysmap/tree/HEAD

Installed? Explore more 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

通过系统地图进行规划

在绘制或构建之前建立共识。地图展示系统行为;聊天保留讨论。规划绝不意味着获得实施产品的许可。

开始或恢复规划前,请先阅读规划指南。它定义了源格式、部件记录、导航和检查项。关于辅助工具设置和命令,请阅读README。

从证据开始

延续对话中已保存的单个 .plan.json 源。阅读其目标、决策、未决问题以及当前规划位置。在描述现有行为之前,先检查相关的项目证据。当源文件较大时,仅加载当前部件及其邻近部件。

对于新对话,选择一个具有描述性的独特源名称。切勿覆盖其他对话的规划。源规划是权威的;生成的图形和清单不可编辑。

区分已确认事实、已商定规划、未知项和未接受的提议。引用证据。切勿根据模糊标签推断早期决策,或为填补缺口而编造事实。

先定义含义,再绘图

对于每个部件,记录其单一职责、输入、工作、结果、规则、下一个接收方、边界和证据。使用指南中定义的字段名称。

将存储与操作分离。区分等待状态与工作。将每个结果连接到下一个部件预期的输入。用一条具体示例遍历所有连接的部件。

使用简短的标签和带名称的箭头。子页面解释其父部件。通过显式的 detail 目标连接它们,切勿用匹配名称或猜测链接。将工具选择、设计问题和关于已移除功能的评论排除在图形之外。

协作并推进

首先回答当前问题。在提出下一个问题之前,先阅读已确定的决策。清晰的变更请求应更新源文件,同时保留不相关的决策。同意仅接受实际展示的提议。

在某个点达成一致后,转向下一个有意义的未解决部件。解释其目的,提出基于实际情况的方法,然后当它改变设计时,提出一个具体的选择。勿将规划变成面试,或止步于“已保存”。

将次要默认值标记为提议。不得在未明确说明的情况下决定权限、隐私、成本或事实证据。在推进之前解决混淆。如果没有实质性决策剩余,则总结就绪状态,并提供审查或单独授权的实施。

在声称完成之前进行检查

更改规划后,构建它并检查受影响的连接和子页面含义。如果浏览器可访问,还需检查图形和导航。诚实地报告不可用的检查项。

辅助工具测试检查结构和生成输出,但不检查系统真实性、真实的浏览器交互或与每个Agent框架的兼容性。

相关技能