module-asis-analysis

Files (4)

• SKILL.md
• openai.yaml · agents/
• asis-output-template.md · references/
• evidence-checklist.md · references/

SKILL.md (first lines)

---
name: module-asis-analysis
version: "2.3.2.2"
description: 对代码仓中某个模块内与特定 SDD 需求、AR、功能点、影响范围或计划变更相关的部分进行 ASIS 逆向分析，并只更新模块目录下的 `.context/详细设计上下文.md`，记录关键事实、证据索引、调用链、工程约束、规格漂移和阻塞项。当前置 TOBE 详细设计、门禁或 AICoding 需要基于代码证据确认现状事实、隐藏约束、依赖、风险、测试覆盖和实现行为时使用。ASIS 阶段不得创建或编辑正式《模块详细设计说明书.md》；正式说明书只能由 TOBE 阶段基于详细设计上下文中的证据生成。必须存在 `.sdd/software_architecture.md`，并且只能以该文件作为模块边界识别依据；缺失时中断。
---

## 前置操作：工作流编排检查

若本 skill 是由 aaw-workflow 的工作单调用的，跳过本节，直接执行正文。

否则，在执行正文之前，先向用户发起一次二选一确认：

> 是否回到 aaw-workflow 工作流中执行？
> - 是，回到工作流（推荐）——进度会被跟踪和上报
> - 否，单独执行本 skill——本次执行将不纳入流程跟踪

- 用户选“是” → 加载 `aaw-workflow` skill，按其流程执行（其入口意图判定会引导继续已有工作流或新建），不再单独执行本 skill 正文。
- 用户选“否” → 继续执行本 skill 正文，之后不再提及工作流。

本节最多询问一次，不得重复打扰。

若工作单输出已存在，仍按当前要求完整执行：先读取并评估已有成果，复用仍有效的信息和已确认答案，可局部修改或整体重写，并写回原路径。

重新核验时保留有效证据编号；失效证据须标记替代，并同步修正相关结论和映射。

# SDD 模块 ASIS 分析

## 阶段规则

本 skill 自身定义 ASIS 阶段必须遵守的规则，可独立使用；无论由何种入口调用，均以本 skill 的规则作为 ASIS 阶段唯一执行依据。

## 运行方式

本 skill 应由当前主 Agent 直接执行，不要通过 SubAgent 启动；遇到需要用户或上游确认的问题，应在当前会话及时问询，避免 SubAgent 的运转模式导致问询滞后。

如果当前环境提供 `ask_user` 工具，ASIS 只能为需求事实、模块边界、现状事实或外部输入缺口发起问询，并在详细设计上下文中记录问题、回答、影响范围和处理结论；工具不可用时，才退回当前会话问询或标记为 `需前置确认`。

ASIS 不得要求用户在实现方案之间做选择。凡是“采用哪种存储”“复用哪个组件”“新增哪个接口”“是否引入调度器”“拦截点放在哪里”等 TOBE 设计选择，ASIS 只能记录为现状约束、可选设计输入或 TOBE 决策点，不得在 ASIS 阶段询问用户拍板。

本 skill 只回答一个问题：现状是什么，哪些不确定。ASIS 服务证据链和边界链，不写完整模块说明书，也不提前设计 TOBE。

## 职责边界

ASIS 负责：

- 确认需求事实、模块边界来源和本次分析切片。
- 查明现有入口、调用链、数据、配置、测试、依赖、隐藏机制和规格漂移。
- 区分 `事实`、`推断`、`待确认` 和 `阻塞相关`。
- 把现状约束、证据、风险、缺口和 TOBE 需要决策的问题记录到 `.context/详细设计上下文.md`。

ASIS 不负责：

- 选择 TOBE 实现方案、存储方案、接口形态、调度机制、评分机制、迁移策略或回滚策略。
- 要求用户从多个实现方案中拍板。
- 把“建议采用”“可以复用”“应新增”写成 ASIS 结论。
- 创建、编辑或补写正式模块详细设计说明书。

如果 ASIS 发现现状无法唯一支持后续设计，应写成 `TOBE 决策输入` 或 `需前置确认`：

- `需前置确认`：需求含义、模块归属、外部事实或上游约束不清，缺少回答会导致 ASIS 无法判断事实或边界。
- `TOBE 决策输入`：事实已经查明，但存在多个设计路径，选择权属于 TOBE 阶段。

## 目标

为目标模块中与本次需求相关的区域产出有代码证据支撑的 ASIS 分析，并更新模块目录下的详细设计上下文：

- `.context/详细设计上下文.md`：记录关键 ASIS 事实、证据索引、模块边界、调用链/数据流、配置/数据/测试/依赖现状、规格漂移/待确认/阻塞和需求/AR 追溯矩阵。
- `模块详细设计说明书.md`：ASIS 阶段不得写入；由 TOBE 阶段读取详细设计上下文后，将必要 ASIS 摘要和证据引用写入正式说明书。

这个 skill 不是用来编写泛化的模块说明书，而是用于支撑模块 TOBE 详细设计和后续编码实现。ASIS 只做现状事实发现，不做最终方案设计。

## 成果物协作规则

遵循用户或当前 SDD 工作流指定的成果物归属规则。默认目录结构为：

- 正式成果物：`.sdd/{SR}/{AR}/{模块组名}/模块详细设计说明书.md`。
- 过程上下文：`.sdd/{SR}/{AR}/{模块组名}/.context/详细设计上下文.md`。
- `{模块组名}` 使用当前工作流确认的模块或模块组目录名；文件名固定，不重复拼接 AR、需求短名或模块组名。
- 本 skill 不得创建、编辑或覆盖正式说明书中的任何章节。
- 本 skill 在详细设计上下文中的写入边界是关键 ASIS 事实（C3）、证据索引（C7）、模块边界（C2）、调用链/数据流（C4）、配置/数据/测试/依赖现状（C5）、规格漂移/待确认/阻塞（C6）和需求/AR 追溯矩阵（C8）。ASIS 的工作过程（线索建立、任务分派、SubAgent 查证、复核动作）不写入 context，留在主 Agent 内部会话中。
- 本 skill 可以读取已有正式说明书、TOBE、风险、任务和门禁章节作为上下文，但不得覆盖这些章节；若发现需要修正，应记录为 ASIS 影响或待确认问题，交由后续 TOBE 阶段处理。
- 如果用户或工作流已提供正式说明书路径，使用同一模块目录下的 `.context/详细设计上下文.md`，除非工作流另有指定。
- 如果正式说明书尚不存在，不创建正式说明书；只创建或输出详细设计上下文。
- 不要在没有依据的情况下另起一份孤立的 ASIS 文档；只有当工作流、用户或成果物拆分规则要求时，才拆分输出。
- 详细设计上下文中的证据编号、ASIS 结论编号、需求/AR 映射编号、待确认问题编号，后续 TOBE 和门禁必须能够复用。
- 更新已有成果物时，只补充或修正详细设计上下文中与 ASIS 有关的章节、证据索引和待确认问题。

## 范围原则

默认分析范围是 `需求相关的模块内 ASIS`。

- 从用户提供的需求、AR、功能点、影响性分析、模块间交互设计或计划变更出发。
- 识别目标模块中受本次需求影响的部分。
- 只分析会影响后续 TOBE 设计、实施任务、风险控制或测试设计的模块区域。
- 为解释行为或隐藏约束，可以向相邻文件、入口、依赖、配置、测试或跨模块交互扩展。
- 只有在用户明确要求完整模块 ASIS，或影响范围无法被可靠收敛时，才扩展到完整模块级 ASIS。

如果分析范围发生扩展，必须说明扩展原因。

如果本次需求高风险、模块低置信度、存在跨模块冷路径或关键隐藏约束无法排除，必须扩大分析范围到相邻入口、反向调用、测试、配置和依赖；若仍无法确认，必须写入待确认问题或 ASIS 阻塞项，不得只把置信度写成 `低` 后继续流转。

开始 ASIS 时必须判断本次变更类型：`既有行为改造`、`纯新增行为` 或 `混合变更`。纯新增行为是指需求明确计划新增能力，且代码检索确认目标入口、对象或配置当前不存在；不能只因搜索不到代码就判定为纯新增。

## 输入

可以接受以下任意组合：

- 当前 SDD 工作流指定的正式说明书路径、配套详细设计上下文路径或当前草稿内容；未指定时使用 `.sdd/{SR}/{AR}/{模块组名}/模块详细设计说明书.md` 和同目录下的 `.context/详细设计上下文.md`，但不创建或编辑正式说明书。
- 目标代码仓路径。
- 需求、功能点、用户故事、缺陷、AR 设计项或计划变更。
- 目标模块名称、目录、包路径、服务、类、API、Job、Consumer 或功能区域。
- 上游 SDD 产物，例如需求分析、功能设计、AR 设计、模块影响性分析、模块间交互设计。
- 用户关注的表、接口、消息主题、配置项、迁移、风险或行为。

如果代码仓可访问，必须直接检查代码。模块边界不得从代码结构推断，必须来自 `.sdd/software_architecture.md`；若该文件缺失、不可读或无法识别目标模块，立即中断。边界确认后，其他关键信息缺失但能从仓库中合理推断时，可以继续分析并显式标记假设。

## 模块边界规则

`.sdd/software_architecture.md` 是 ASIS 的必要输入和唯一模块边界来源。

From pi-ixel/Awesome-Agent-Workflow, MIT.

More from pi-ixel/Awesome-Agent-Workflow