SuperAPI AI 工具集

brain-to-docs

通用与其它

查看项目

更新于 10-16 05:41

技能介绍

用途:当用户希望把项目愿景、决策或偏好沉淀为长期文档时使用;也用于通过来回访谈来构建 README 与 ADR。其目标是尽量把用户的品味、判断、知识、愿景、偏好和决策提取为文本,保存为清晰简洁的 Markdown 文档:README 承载愿景,docs/adr/ 承载决策。

循环流程:每次先检查文档,在做任何事之前先读 docs/adr/(以及 README.md),因为其他智能体和人员会不断新增或修改 ADR。通过宿主支持的问题接口或纯文本提出一小组聚焦问题,默认 2–3 个,除非用户要求不同数量;问题要高度多样、覆盖不同角度,避免全是同一类型(如全是技术栈、产品方向或变现)。例外:若用户指定了具体关注领域,则遵循。用户回答其认为最有用的部分。把已确认的回答整合进获授权的文档,保留未回答的问题,并区分暂定想法与已接受的决策;由技能判断是更新 README.md 还是新建 ADR。重复直到用户表示“完成”或类似表述。

规则:整个过程中的所有回答与回复必须非常简洁,句子要短,并使用用户要求的语言。ADR 短小,命名为 NNNN-slug.md,包含 Status + Context + Decision + Consequences。README 要保留现有的安装、使用与贡献者部分;愿景放在合适位置,详细决策放入 ADR。除非用户要求或正在犯严重错误,不要挑战用户的想法。

限制:改编自 davidondrej/skills;行动前需核实本地路径、工具、凭据和智能体功能。对于命令、远程访问、调度、浏览器自动化或修改文件的工作流,需获得用户明确批准,并先确认目标环境。