SuperAPI AI 工具集

kiss-arch-extraction

数据与分析

查看项目

更新于 10-15 20:33

技能介绍

用途:从已有代码库中反向提取架构,梳理容器、组件、数据流与外部依赖,产出架构文档,作为新 ADR 的种子材料。

主要能力:读取配置文件(compose / k8s / terraform / ci)、入口模块,推断容器与依赖图;标记看似隐式做出、缺少 ADR 的决策。不修改代码,也不在无证据时声称意图。

输入:.kiss/context.yml;{context.paths.docs}/analysis/codebase-scan.md;源码树。输出:{context.paths.docs}/architecture/extracted.md 与 extracted.extract。不修改 .kiss/context.yml。

使用方式:交互模式(KISS_AGENT_MODE=interactive,默认)下以引导式问卷运行,一次一个问题,优先是/否,提供 A/B/C/D 选项并附白话说明,始终给出推荐选项;not sure / skip 会应用合理默认值并记入债务文件。自动模式(KISS_AGENT_MODE=auto 或 --auto)跳过问卷,直接采用上游默认值并记录决策。命令示例:bash <SKILL_DIR>/kiss-arch-extraction/scripts/bash/extract.sh --auto,其中 <SKILL_DIR> 为集成技能的根目录(如 Claude Code 的 .claude/skills/、Antigravity / Codex 的 .agents/skills/、Cursor 的 .cursor/skills/、Windsurf 的 .windsurf/workflows/)。

衔接:kiss-c4-diagrams 将提取结构转为 C4 Mermaid;kiss-adr 为代码中隐含决策(如选用 PostgreSQL)生成候选 ADR。

限制:仅做提取与推断,不改代码;不臆测意图;具体平台支持与收费信息暂未提供。