SuperAPI AI 工具集

agent-spec-wiki

编程与开发

查看项目

更新于 10-16 06:51

技能介绍

用途:维护和审查仓库内的代码实时 wiki,把 .agent-spec/wiki/ 作为智能体工作记忆,而非知识真源;持久真源放 knowledge/,可执行契约放 specs/,读者文档放 docs/。

主要能力:wiki 初始化与种子生成、状态检查、文本查询、按路径查看关联 wiki 页面与需求/任务规格、Rust 架构清单(基于 Cargo 元数据,可输出 JSON 或 Mermaid)、项目地图、索引、lint 与 check、元数据更新。每篇维护中的文章需保留 source_files frontmatter。

使用方式:常用命令包括 agent-spec wiki init --code . --wiki .agent-spec/wiki、agent-spec wiki seed --code . --wiki .agent-spec/wiki、agent-spec wiki status --code . --wiki .agent-spec/wiki、agent-spec wiki query "intent compiler" --wiki .agent-spec/wiki、agent-spec wiki inspect src/spec_wiki/live.rs --code . --wiki .agent-spec/wiki、agent-spec wiki inventory --code . --format json、agent-spec wiki project-map --code . --wiki .agent-spec/wiki --format json --out .agent-spec/wiki/architecture/project-map.json、agent-spec wiki index --wiki .agent-spec/wiki、agent-spec wiki lint --code . --wiki .agent-spec/wiki、agent-spec wiki check --code . --wiki .agent-spec/wiki。代码或架构变更后应更新受影响文章,再运行 index 与 lint/check。

适用场景:Rust 项目的架构清单与 Mermaid 图;非 Rust 项目仍支持状态、索引、lint 与元数据;跨项目 wiki 用 projects/ 与 flows/ 文章记录依赖项目与数据流。

限制:无内置 LLM 长文 wiki 生成、无 Web UI,不替代 KLL 需求或决策;拒绝符号链接;无生成文档/wiki 兼容模式;project-map 的 JSON 与 Mermaid 为派生产物,真源仍是项目与流程文章;wiki lint 与 check 要求派生产物与文章完全一致。