SuperAPI AI 工具集

maka-architecture-docs

写作与研究

查看项目

更新于 10-15 16:51

技能介绍

用途:为 Maka Agent 后端编写中英双语架构文档,覆盖起草、重构、翻译、评审与术语结构统一五种任务模式,约束写作质量、证据、双语一致性和评审标准,但不改变用户选定主题与文档组织方式。

主要能力:可按请求确认任务模式(起草、改写、翻译、评审、标准化);建立文章契约(核心问题、目标读者、阅读深度、源语言、实现状态);收集证据时检查相关代码路径、测试、schema、配置、ADR 与既有文档,区分已验证行为与计划或解读;按问题—直觉—场景—机制—边界—失败—权衡组织叙述,并补充技术锚点。

使用方式:起草、改写或标准化时查阅 references/writing-standard.md;创建或评审双语版本时查阅 references/bilingual-standard.md;可选用 assets/article-template.md 作为起始脚手架;完成后按 references/quality-gate.md 进行质量门检查,未通过必查项不得视为完成。产出文件需遵循仓库现有文档布局,语言对应版本置于匹配相对路径或共享稳定文档 ID。

适用场景:Maka Agent 后端的架构说明、设计决策、机制解释与双语同步维护。

限制与规则:不得编造主题或替换用户大纲;未经验证的设计假设不得表述为当前实现;必须区分 Current、Planned、Exploratory、Deprecated、Historical;翻译不得强化或弱化原声明;避免同义术语混用;评审需按影响排序并引用具体章节或行。具体平台、收费、价格及更多安装细节在提供资料中暂未提供。