SuperAPI AI 工具集

cs-arch

编程与开发

查看项目

更新于 10-15 20:21

技能介绍

cs-arch 用于维护 .codestable/architecture/ 这份只记现状的系统地图,是起草、刷新、体检架构文档的统一入口。启动前需先读取 .codestable/attention.md,缺失则提示补齐或运行 cs-onboard。

用途:architecture 是累积的、自给自足的系统地图,记录所有已落地 feature 沉淀下来的系统现状,供 design 定位、issue-analyze 理解模块边界、新人了解系统结构。只记现状不记计划,目标态架构归 cs-roadmap。

三种模式:update 按代码最新状态刷新已有文档;check 检查一致性,含 design-internal、design-vs-code、architecture-folder-internal 三个子目标;backfill 为已存在但没写过档的模块补一份。每次只跑一个模式且只锁定一个目标。

工作流分六阶段:锁定目标、读取材料、执行、自查或输出报告、用户 review、落盘或结束。backfill 写入 architecture/{type}-{slug}.md,frontmatter 含 doc_type、status、last_reviewed,并更新 ARCHITECTURE.md 索引;同类文档在根目录达 6 份需按分组规则搬迁。update 覆盖已有文件并更新 last_reviewed。check 只出报告不落盘。

硬性边界:只锚代码不造系统,每条结构化断言需锚到 file:line,锚不到标 TODO;不替用户拍板决策;check 只检查不修复;不改代码、不动 spec;不发散,范围外问题记观察项。

与其他工作流配合:cs-req 写能力原因,本技能写实现结构;cs-feat-design 读本技能文档;cs-feat-accept 验收时更新文档;cs-decide 拍板后 update 补引用;cs-issue-analyze 读文档定位边界;cs-onboard 建占位;cs-roadmap 记规划。

限制:模块尚未在代码中实现时不应走 backfill,应转 cs-roadmap;check 不修改任何文件;具体文档结构模板、检查覆盖项、报告格式见 reference.md,共享路径与命名约定见 shared-conventions.md。