SuperAPI AI 工具集

spike

通用与其它

查看项目

更新于 10-15 22:41

技能介绍

Spike 的用途是产出一条简洁、聚焦的现状叙述,回答“今天它是如何运作的”。它面向需要理解现有代码路径的协作者,强调只描述当前行为,不写规格、设计文档或未来方案。

主要能力与写作原则:使用主动语态,明确谁在行动(用户、worker、外部系统),而非哪个模块“处理”某事;以平实散文为主,模块和函数名只在最清晰时出现;不要以模块作主语开头,而应先说用户或系统做什么,再用链接锚定该节拍。叙述从可识别的入口点(面向用户的功能、API 或主任务)开始,只追踪与该具体问题相关的层,按时间顺序推进:谁做什么、什么先运行、输出如何成为下游输入。每段最多 3 句,一段一个主要节拍,段落以新的行动者或阶段开头,留出空白便于略读。

锚点与代码引用:每个主要节拍嵌入一个 markdown 链接,链接标签是句子中读起来自然的词或短语(通常是动词或短句),不是模块名、文件路径或 Module.function 字符串。链接目标需先用 realpath 解析文件,如 realpath lib/path/to/file.ex,用其输出作为 URL,必要时追加 #L… 跳转到具体定义;不要使用相对路径。不要为每个 helper、回调或符号都加链接。

工作流程:不修改代码、测试、配置或项目资产,纯调查与协作。先阅读相关模块、调用点、测试、工单和文档,直到能清晰追踪路径;再按上述原则线性写作;最后对照反模式复查,删减链接泛滥、模块作主语开头和被动句,直到读起来像紧凑的走查而非符号索引。

限制:不写前言,不写规格或设计文档,不超范围编目整个系统,不使用未来时态或实现建议,不使用图表、表格或视觉辅助,不使用“flows”“feeds”“lands in”等叙述捷径。资料未提供具体安装命令、收费、平台或效果信息。