aisdlc-project-discover-level0-memory
aisdlc-project-discover-level0-memory(Step2:Level-0 / Memory)
概览
Memory 的目标是“3 分钟可入场”:项目是什么、边界是什么、怎么跑、怎么验证、权威入口在哪。
写法约束:短、只写稳定入口与边界、用证据链接。
开始时宣布:「我正在使用 aisdlc-project-discover-level0-memory 技能生成项目级 Memory(structure/tech/product/glossary)。」
输出文件(固定 4 份)
.aisdlc/project/memory/structure.md.aisdlc/project/memory/tech.md.aisdlc/project/memory/product.md.aisdlc/project/memory/glossary.md
最小模板(可复制)
memory/structure.md
- 项目形态:单体/多服务/Monorepo(写证据入口:目录/脚本/CI)
- 入口(必须可定位):
- 本地启动:
<命令或脚本路径> - 测试:
<命令或脚本路径> - 构建/发布:
<CI job 配置路径 或 脚本>
- 本地启动:
- 地图入口:
- 组件索引:
../components/index.md - 契约索引:
../contracts/index.md - 运行入口:
../ops/(若有)
- 组件索引:
## 证据入口清单(临时)(来自 Step0 的草稿,后续拆散回填)
memory/tech.md
- 技术栈(只列稳定选择):语言/框架/数据库/消息/网关
- 工程护栏入口:lint/test/安全扫描(命令与 CI job 配置位置)
- NFR 护栏入口:性能/可用性/成本/安全(链接到
../nfr.md或外部规范)
memory/product.md
- 业务边界:In/Out(一句话 + 证据入口链接)
- 关键业务模块入口:
../products/index.md(若有) - 关键术语入口:
./glossary.md
memory/glossary.md
- 术语:定义(1 句)+ 权威出处链接(契约页/代码类型/ADR/外部文档)
常见错误
- 把 Memory 写成“项目说明书”:Memory 只做入口与边界,细节应链接到模块页/契约页/ops。
- 为了显得完整而脑补:没有证据就写“未发现 + 下一步如何找到”,不要猜。
红旗清单(出现任一条:停止并纠正)
- Memory 出现字段级约束、详细时序、迁移步骤、操作手册完整版
- “先写一大段概述,入口链接以后补”(入口是 Memory 的核心)
- 术语没有权威出处链接(会变成口头定义,快速漂移)
More from zixun-github/aisdlc
spec-product-prd
Use when 需要在 sdlc-dev 的产品需求 Spec 流程执行 R2,将 requirements/solution.md 转写为可交付、可验收、可测试的 requirements/prd.md,且需要避免猜路径、在缺少 solution.md 时仍继续生成、或用“待确认问题/Open Questions”替代验证清单。
126subagent-driven-development
Use when executing implementation plans with independent tasks in the current session
109spec-product-demo
Use when 需要在 sdlc-dev 的产品需求 Spec 流程执行 R4(基于 requirements/prototype.md 生成可交互 Demo 工程),并需要避免跳过 spec-context、在缺少 prototype.md 或缺少可运行 Demo 工程根目录时仍继续、或自创页面/目录导致不可追溯与无法回流闭环。
109spec-receiving-code-review
Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation
108spec-design
Use when 需要为某个 Spec Pack 产出 D2 决策文档(RFC/Decision Doc),且必须强制消费项目知识库与 `{FEATURE_DIR}/requirements/solution.md#impact-analysis`;适用于在时间/权威压力下容易只读索引、跳过受影响模块/ADR 全文、静默忽略缺失输入或不写 `CONTEXT GAP`、以及遗漏“与现有系统对齐”自检的情况。
104spec-init
Use when 需要在本仓库的 AI SDLC 流程中初始化新的 Spec Pack(创建三位编号分支与 `.aisdlc/specs/{num}-{short-name}` 目录),或在执行 `spec-init` 时不确定输入解析、短名称规则、UTF-8 BOM 文件路径传参、脚本调用方式与输出物。
103