project-discover-memory-index

安装量: 69
排名: #11095

安装

npx skills add https://github.com/zixun-github/aisdlc --skill project-discover-memory-index

project-discover-memory-index(Step2+3:Level-0 Memory + Level-1 索引骨架) 概览 这一阶段的目标是: 让任何人/AI 在几分钟内知道项目边界、权威入口、怎么跑/怎么验、从哪里进入模块与契约 。 方法是:先把 Memory 与索引骨架落盘,并严格执行“索引只导航”的硬规则。 开始时宣布: 「我正在使用 project-discover-memory-index 技能建立 Discover 的北极星(memory)与索引骨架(地图层)。」 输出目录(标准落盘) .aisdlc/project/ memory/ structure.md tech.md product.md glossary.md components/ index.md products/ index.md 提醒 :本阶段不要创建 .aisdlc/project/contracts/** ;契约入口将通过模块页锚点跳转。 Level-0:Memory 写法约束(必须短) 通用硬规则 只写稳定入口与边界 :入口链接 > 解释性长文 避免一次性交付细节 :详细迁移步骤/详细时序/字段级约束不写在项目级 memory 链接必须可定位 :优先链接到仓库内具体文件、具体 job、具体命令入口 缺口必须结构化 :统一写到

Evidence Gaps(缺口清单)

memory/structure.md 最小模板

结构与入口(北极星)

项目形态

单体/多服务/Monorepo: < 证据入口链接

入口(可执行证据)

本地启动:<脚本/命令入口链接>

测试:<脚本/命令入口链接>

构建/发布:

代码地图

组件地图:../components/index.md

业务地图(如有):../products/index.md

Ops 入口(如有):../ops/index.md

Evidence Gaps(缺口清单)

缺口:

期望补齐到的粒度:

候选证据位置:

影响: memory/tech.md 最小模板

技术栈与工程护栏

技术栈(稳定选择)

语言/框架:

数据库/缓存/消息:

质量门禁入口(可执行证据)

lint:

test:

安全扫描:

NFR 入口

性能/可用性/成本/安全:../nfr.md(或外部权威链接)

Evidence Gaps(缺口清单) ... memory/product.md 最小模板

业务边界(稳定语义)

In / Out

In:

Out:

业务地图入口

../products/index.md(如有)

术语入口

./glossary.md

Evidence Gaps(缺口清单) ... memory/glossary.md 最小模板

术语表(短) | 术语 | 一句话定义 | 权威出处 | |


|

|

| | xxx | ... | <链接到模块页锚点/ADR/代码证据> | Level-1:索引骨架(地图层)约束 索引硬规则(可检查) components/index.md 与 products/index.md 只做导航 禁止在索引中出现: 不变量摘要 字段/错误码/详细流程 “待补/未发现/TODO/待确认” 索引用复选框做进度面板,但 不得 作为完成判断依据(完成只看模块页是否达标) components/index.md 最小模板(含依赖图)

Components Index(地图层:只导航) | module | priority | owner | code_entry | api_contract | data_contract | ops_entry | status | |


|

|

|

|

|

|

|

| | auth | P0 | team-x | src/auth/ | api | data | ops | - [ ] |

Dependencies(direct only) ```mermaid graph LR auth -->|API| user order -->|Event| billing

维护规则:只画直接依赖(一级调用),不画传递依赖;边标注交互方式(API/Event/DB)。

products/index.md 最小模板(可选,但建议)

```markdown

Products Index(业务地图:只导航)

建议收敛到 <= 6 个业务模块;这里不是功能清单。 | product | owner | entry | related_components | status | |---|---|---|---|---| | commerce | team-a | ./commerce.md | auth, order | - [ ] | 红旗清单 Memory 写成“操作手册大全”(项目级必须短) 索引里出现“待补/未发现/TODO”(缺口应进模块页或 memory 的 Evidence Gaps) 在索引里复制模块细节(双写必漂移) 常见错误 先写模块页细节再补索引(会诱发索引双写) 把 Products 变成 20+ 个模块的功能目录(地图失效)

返回排行榜