원클릭으로 Manus에서 모든 스킬 실행

architect-doc

스타178

포크23

업데이트2026년 6월 18일 12:59

维护 .ai_state/architecture/ 长效档案 (项目现状档). Refactor/System 路径完成后强制更新 ARCHITECTURE.md 总入口 + {type}-{slug}.md 子系统档. 注: 不同于 cx 端的 architect.toml subagent (后者是 design stage 工作者).

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

WenJunDuan

WenJunDuan/Rlues

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

/architect-doc — 架构现状档维护 (v9.6.4 Sprint D 新)

触发时机

时机	强制度	责任
System 路径 ship 完成	强制	主 agent
Refactor 路径改动 ≥ 5 文件	强制	主 agent
用户显式 `/architect-doc update {type}-{slug}`	触发	主 agent
Feature 路径完成 (新增 endpoint / 新数据模型)	可选	主 agent 判断
athena-init 首次	创建 ARCHITECTURE.md 初版	athena-init

delivery-gate 联动

Refactor / System (≥ 5 文件) + stage=ship 时, delivery-gate hook 检查:

读 _index.path 和本 sprint 改动文件数 (从 evidence.yaml)
若满足强制条件:
- 检查 architecture/ARCHITECTURE.md mtime ≥ 本 sprint 开始时间
- 检查改动涉及的子系统对应 {type}-{slug}.md mtime ≥ 本 sprint 开始时间
不满足 → block + 提示 /architect-doc update

工作流

创建初始档 (athena-init 顺带)

athena-init 时, 主 agent:

检测项目是否已有 README.md / docs/architecture/ / ARCHITECTURE.md
是 → 引导用户从中提取关键信息 → 写 .ai_state/architecture/ARCHITECTURE.md 初版
否 → 询问用户基本架构问题 (用什么 DB / API 风格 / 部署方式) → 生成最简版

更新已有档

主 agent 读当前 sprint 的 design.md + git diff
判断改动涉及哪些子系统 (heuristic: 检测 src/{module}/ 路径模式)
(可选) spawn architect subagent (read-only sandbox, ultrathink) 生成 patch
主 agent apply patch + 更新 mtime
更新 _index.pointers.latest_architecture_update

新增子系统档

System 路径引入新子系统时:

主 agent 询问用户 type (从枚举选):
- api / db / auth / cache / frontend / backend
- infra / messaging / monitoring / cli / lib
创建 architecture/{type}-{slug}.md (从模板)
更新 ARCHITECTURE.md 索引段

文件结构

.ai_state/architecture/
├── ARCHITECTURE.md         # 总入口 + 索引 (强制存在)
└── {type}-{slug}.md        # 子系统档 (按需创建)

例:

api-rest.md
db-postgres.md
auth-jwt.md
cache-redis.md
frontend-react.md
infra-k8s.md

不要做

不写演进历史 (那是 git log + compound/decision-*.md)
不写实现细节 (那是源码)
不重复 design.md (design 是某次 sprint 的设计, architecture 是当前现状)
不写未实现的设想 (那是 roadmap)

与 design.md / compound 的关系

design.md (sprint 一次性, 写"这次要改 X")
    ↓ ship 后
architecture/{type}-{slug}.md (长效, 写"X 现在长这样")
    ↓ 重大决策同步
compound/decision-*.md (永久, 写"为什么这样选")

三者各司其职, 不冗余.

archive 机制 (借 OpenSpec /opsx:archive)

跨季度时, 旧的 compound/ 和已 ship 的 sprints/ 自动归档:

触发: 新 quarter 第一个 sprint 启动时, 主 agent 检测
动作: 把上 quarter 的内容移到 .ai_state/archive-{quarter}/
主 compound/ 只保留近 1 个季度 + 近 5 个 decision (永远保留所有 decision)

architecture/ 不归档 (永远是现状).

模板

见 ~/.codex/skills/pace/templates/architecture/

이 저장소의 다른 Skills

같은 저장소

athena-setup

WenJunDuan/Rlues

Athena 全局首次配置 (跨项目, 一次性). 从分发包部署 settings/config/rules/standards/hooks/agents/skills 到 ~/.claude/ (CC) 与 ~/.codex/ (CX). 和 athena-init 区别: setup 全局一次性, init 每项目一次. 已装则转 verify/upgrade (走 athena-migrate).

2026-06-23178

athena-checkpoint

WenJunDuan/Rlues

会话记忆固化 skill (v9.8.0 新). 会话结束/中途, agent 自己总结本会话增量写进 .ai_state (_index.md 当前状态 + sprints/{slug}/session-log.md), 免去用户每次手动描述一堆让它存. 手动 /checkpoint 触发. 与 compact-snapshot hook 互补 (hook 机械兜底, skill 做需推理的总结).

2026-06-22178

athena-dev

WenJunDuan/Rlues

Athena 主入口 skill. 接收用户任务, 做 PACE 路由分诊 (brainstorm/roadmap/plan/...), 启动对应 stage. v9.7.0: 铁律引用名称化 (CC/CX 编号非对称, 引用一律用铁律[名称]).

2026-06-22178

athena-init

WenJunDuan/Rlues

Athena 项目初始化 skill. 在项目中执行 /athena-init 时调用. 职责: 探测平台 / 工具可用性, 创建 .ai_state/ 目录 + 复制 _index.md 模板 + 填入探测结果.

2026-06-22178

athena-issue

WenJunDuan/Rlues

Bugfix 路径的结构化问题流程: report → analyze → fix-note 三件套档案, 落在 sprints/{slug}/. 把"偏轻"的 Bugfix 升级成可复现 / 可追溯 / 可复盘. 借 CodeStable issue 实体, 适配 agent-in-loop.

2026-06-22178

athena-migrate

WenJunDuan/Rlues

Athena 版本迁移工具. v9.6.4 重写: 含 v9.6.2 → v9.6.4 破坏式重构 (sprints/ + compound/ + 4 新 ai_state 文件 + lessons.md 三选项交互).

2026-06-22178

name	architect-doc
description	维护 .ai_state/architecture/ 长效档案 (项目现状档). Refactor/System 路径完成后强制更新 ARCHITECTURE.md 总入口 + {type}-{slug}.md 子系统档. 注: 不同于 cx 端的 architect.toml subagent (后者是 design stage 工作者).
effort	medium

/architect-doc — 架构现状档维护 (v9.6.4 Sprint D 新)

触发时机

时机	强制度	责任
System 路径 ship 完成	强制	主 agent
Refactor 路径改动 ≥ 5 文件	强制	主 agent
用户显式 `/architect-doc update {type}-{slug}`	触发	主 agent
Feature 路径完成 (新增 endpoint / 新数据模型)	可选	主 agent 判断
athena-init 首次	创建 ARCHITECTURE.md 初版	athena-init

delivery-gate 联动

Refactor / System (≥ 5 文件) + stage=ship 时, delivery-gate hook 检查:

读 _index.path 和本 sprint 改动文件数 (从 evidence.yaml)
若满足强制条件:
- 检查 architecture/ARCHITECTURE.md mtime ≥ 本 sprint 开始时间
- 检查改动涉及的子系统对应 {type}-{slug}.md mtime ≥ 本 sprint 开始时间
不满足 → block + 提示 /architect-doc update

工作流

创建初始档 (athena-init 顺带)

athena-init 时, 主 agent:

检测项目是否已有 README.md / docs/architecture/ / ARCHITECTURE.md
是 → 引导用户从中提取关键信息 → 写 .ai_state/architecture/ARCHITECTURE.md 初版
否 → 询问用户基本架构问题 (用什么 DB / API 风格 / 部署方式) → 生成最简版

更新已有档

主 agent 读当前 sprint 的 design.md + git diff
判断改动涉及哪些子系统 (heuristic: 检测 src/{module}/ 路径模式)
(可选) spawn architect subagent (read-only sandbox, ultrathink) 生成 patch
主 agent apply patch + 更新 mtime
更新 _index.pointers.latest_architecture_update

新增子系统档

System 路径引入新子系统时:

主 agent 询问用户 type (从枚举选):
- api / db / auth / cache / frontend / backend
- infra / messaging / monitoring / cli / lib
创建 architecture/{type}-{slug}.md (从模板)
更新 ARCHITECTURE.md 索引段

文件结构

.ai_state/architecture/
├── ARCHITECTURE.md         # 总入口 + 索引 (强制存在)
└── {type}-{slug}.md        # 子系统档 (按需创建)

例:

api-rest.md
db-postgres.md
auth-jwt.md
cache-redis.md
frontend-react.md
infra-k8s.md

不要做

不写演进历史 (那是 git log + compound/decision-*.md)
不写实现细节 (那是源码)
不重复 design.md (design 是某次 sprint 的设计, architecture 是当前现状)
不写未实现的设想 (那是 roadmap)

与 design.md / compound 的关系

design.md (sprint 一次性, 写"这次要改 X")
    ↓ ship 后
architecture/{type}-{slug}.md (长效, 写"X 现在长这样")
    ↓ 重大决策同步
compound/decision-*.md (永久, 写"为什么这样选")

三者各司其职, 不冗余.

archive 机制 (借 OpenSpec /opsx:archive)

跨季度时, 旧的 compound/ 和已 ship 的 sprints/ 自动归档:

触发: 新 quarter 第一个 sprint 启动时, 主 agent 检测
动作: 把上 quarter 的内容移到 .ai_state/archive-{quarter}/
主 compound/ 只保留近 1 个季度 + 近 5 个 decision (永远保留所有 decision)

architecture/ 不归档 (永远是现状).

模板

见 ~/.codex/skills/pace/templates/architecture/