@ecc-hgy/ae 0.5.0 → 0.6.0

package/templates/entries/README.md

@@ -1,32 +1,34 @@
-# {{PROJECT_NAME}}
-
-> {{PROJECT_GOAL}}
-
-<!--
-根 README 的核心:让别人 30 秒搞清「为什么有用、能做什么、怎么用」。
-下面是建议骨架,按需增删、不必都填,也不必拘泥小节名:
-- 它是什么 + 一句话价值 → 上面的标题 + 一行(已占位)
-- 为什么 / 给谁 → 解决什么问题、面向谁
-- Quick Start → 最快见效的一段命令 / 步骤(装好 + 第一个能见效的操作)
-- 使用示例 → 典型场景(必要时再贴一段真实用法)
-- 目录地图 / 文档入口 → 关键目录 + 深入文档的链接
--->
-
-## 这是什么
-
-TODO: 一段话说清它解决什么问题、给谁用、用它能做什么。
-
-## Quick Start
-
-TODO: 最快跑起来的命令或步骤。
-
-<!-- ## 使用示例 —— 有典型场景时再加,贴一段真实用法 -->
-
-## 目录地图
-
+# {{PROJECT_NAME}}
+
+> {{PROJECT_GOAL}}
+
+<!--
+根 README 的核心:让别人 30 秒搞清「为什么有用、能做什么、怎么用」。
+下面是建议骨架,按需增删、不必都填,也不必拘泥小节名:
+- 它是什么 + 一句话价值 → 上面的标题 + 一行(已占位)
+- 为什么 / 给谁 → 解决什么问题、面向谁
+- Quick Start → 最快见效的一段命令 / 步骤(装好 + 第一个能见效的操作)
+- 使用示例 → 典型场景(必要时再贴一段真实用法)
+- 目录地图 / 文档入口 → 关键目录 + 深入文档的链接
+-->
+
+## 这是什么
+
+TODO: 一段话说清它解决什么问题、给谁用、用它能做什么。
+
+## Quick Start
+
+TODO: 最快跑起来的命令或步骤。
+
+<!-- ## 使用示例 —— 有典型场景时再加,贴一段真实用法 -->
+
+## 目录地图
+
 - `spec/`:SDD/TDD 规格产物——需求索引看 `spec/INDEX.md`,项目地图看 `spec/README.md`。
-- `reference/`:原始素材,只读心态。
-- `data/`:运行产物、导出、缓存。
-- `scripts/`:辅助脚本。
-
-<!-- 文档入口:AGENTS.md(项目指令)· handoff.md(当前态快照)· spec/INDEX.md(需求索引) -->
+- `src/`:业务代码、程序入口与脚本;按职责组织,不要求与 `spec/needs/` 一一对应。
+- `tests/`:测试代码与测试样例。
+- `docs/`:原始文档资料、说明与长期维护的知识。
+- `data/`:各类数据与运行结果,内部按项目需要渐进组织。
+- `dist/`:构建产物;有构建时由工具生成。
+
+<!-- 文档入口:AGENTS.md(项目指令)· handoff.md(当前态快照)· spec/INDEX.md(需求索引) -->

package/templates/entries/handoff.md

@@ -1 +1 @@
-<!-- 跨会话/跨项目进展交接，由 handoff skill 在会话结束时人工触发更新。 -->
+<!-- 跨会话/跨项目进展交接，由 handoff skill 在会话结束时人工触发更新。 -->

package/templates/entries/spec/ADR/AGENTS.md

@@ -1,30 +1,30 @@
-# spec/ADR/ 规则
-
-> 架构决策记录(ADR)规则。在 `spec/ADR/` 下创建或修改 ADR 时遵守本文件。
-
-## 命名
-
-`NNNN-<标题>.md`,**4 位序号**,kebab-case 标题。例:`0001-postgres-as-primary-store.md`。
-
-## frontmatter
-
-```yaml
----
-status: accepted          # proposed | accepted | superseded
-date: 2026-06-14
-supersedes: 0000-xxx.md   # 仅当取代旧 ADR 时填
----
-```
-
-正文按具体决策自然组织(背景 / 决策 / 理由 / 影响),不强加重模板。
-
-## 状态机
-
-```text
-proposed ─(评审接受)─► accepted ─(新 ADR 取代)─► superseded
-```
-
-- `proposed`:新提案,未拍板(由 writing-plans / review / improve-codebase-architecture 创建时默认)。
-- `accepted`:已评审接受;视为**约束**,其他需求不得违背。
-- `superseded`:被新 ADR 取代;新 ADR 的 `supersedes` 指回旧编号,**不删旧文件**。
-
+# spec/ADR/ 规则
+
+> 架构决策记录(ADR)规则。在 `spec/ADR/` 下创建或修改 ADR 时遵守本文件。
+
+## 命名
+
+`NNNN-<标题>.md`,**4 位序号**,kebab-case 标题。例:`0001-postgres-as-primary-store.md`。
+
+## frontmatter
+
+```yaml
+---
+status: accepted          # proposed | accepted | superseded
+date: 2026-06-14
+supersedes: 0000-xxx.md   # 仅当取代旧 ADR 时填
+---
+```
+
+正文按具体决策自然组织(背景 / 决策 / 理由 / 影响),不强加重模板。
+
+## 状态机
+
+```text
+proposed ─(评审接受)─► accepted ─(新 ADR 取代)─► superseded
+```
+
+- `proposed`:新提案,未拍板(由 writing-plans / review / improve-codebase-architecture 创建时默认)。
+- `accepted`:已评审接受;视为**约束**,其他需求不得违背。
+- `superseded`:被新 ADR 取代;新 ADR 的 `supersedes` 指回旧编号,**不删旧文件**。
+

package/templates/entries/spec/ADR/CLAUDE.md

@@ -1,5 +1,5 @@
-# spec/ADR/
-
-**Always read [AGENTS.md](./AGENTS.md) in this directory before creating or editing an ADR.**
-
-`spec/ADR/AGENTS.md` defines ADR naming, frontmatter, and the proposed/accepted/superseded state machine.
+# spec/ADR/
+
+**Always read [AGENTS.md](./AGENTS.md) in this directory before creating or editing an ADR.**
+
+`spec/ADR/AGENTS.md` defines ADR naming, frontmatter, and the proposed/accepted/superseded state machine.

package/templates/entries/spec/AGENTS.md

@@ -1,35 +1,35 @@
-# spec/ 规则
-
-> 本目录(`spec/`)的工作规则。在 `spec/` 下读写文件时遵守本文件。
-
-## 总领
-
-S1 节点 → 产物 → skill 的路由总览,见随包的 `using-agentic-engineering` skill——它判定"进不进 AE 流程"并分发到各节点。
-
-两道硬门禁:**A1 未对齐不写 prd**;**B2 期望态未对齐不修复**。
-
-
-## R1:落盘后同步 INDEX
-落盘 `spec/needs/<需求名>/` 下任何文件后,**必须同步更新 `spec/INDEX.md`** 对应行。若不确定如何更新,按上面「INDEX 推导规则」手动重算(未来可用 `ae index-rebuild` 幂等重扫)。
-
-### INDEX 推导规则
-
-`spec/INDEX.md` 给模型看:一次扫描看到所有需求 + 状态 + 进度。`当前节点` 列**不存储**在任何 frontmatter,由该需求下文件状态**实时推导**:
-
-| 条件 | 当前节点 |
-|------|---------|
-| prd 不存在 或 status=draft | A1 / A2 |
-| prd active + design 不存在/draft | A3 设计 |
-| prd+design active + todo 不存在 | A4 拆解 |
-| prd+design active + todo 有未完成项 | A5 执行 |
-| todo 全勾 + 未端到端验证 | A6 verify |
-| 所有 issues 已验收 + 已交付 | 已完成 |
-| 存在 active 的 issues | 进 B 子路径,按 issues 状态推 B2…B7 |
-| prd / design 任一 archived | 已归档 |
-
-- INDEX 是**推导态**:文件状态变就重新推导,**不要手编 `当前节点` 列**。
-
-
-## 何时升 ADR
-
+# spec/ 规则
+
+> 本目录(`spec/`)的工作规则。在 `spec/` 下读写文件时遵守本文件。
+
+## 总领
+
+S1 节点 → 产物 → skill 的路由总览,见随包的 `using-agentic-engineering` skill——它判定"进不进 AE 流程"并分发到各节点。
+
+两道硬门禁:**A1 未对齐不写 prd**;**B2 期望态未对齐不修复**。
+
+
+## R1:落盘后同步 INDEX
+落盘 `spec/needs/<需求名>/` 下任何文件后,**必须同步更新 `spec/INDEX.md`** 对应行。若不确定如何更新,按上面「INDEX 推导规则」手动重算(未来可用 `ae index-rebuild` 幂等重扫)。
+
+### INDEX 推导规则
+
+`spec/INDEX.md` 给模型看:一次扫描看到所有需求 + 状态 + 进度。`当前节点` 列**不存储**在任何 frontmatter,由该需求下文件状态**实时推导**:
+
+| 条件 | 当前节点 |
+|------|---------|
+| prd 不存在 或 status=draft | A1 / A2 |
+| prd active + design 不存在/draft | A3 设计 |
+| prd+design active + todo 不存在 | A4 拆解 |
+| prd+design active + todo 有未完成项 | A5 执行 |
+| todo 全勾 + 未端到端验证 | A6 verify |
+| 所有 issues 已验收 + 已交付 | 已完成 |
+| 存在 active 的 issues | 进 B 子路径,按 issues 状态推 B2…B7 |
+| prd / design 任一 archived | 已归档 |
+
+- INDEX 是**推导态**:文件状态变就重新推导,**不要手编 `当前节点` 列**。
+
+
+## 何时升 ADR
+
 决策影响**多个需求**或属项目级不变量时,从 `design.md` 升到`spec/ADR`(判断:推翻它会改动 >1 个需求)。单需求的技术决策留在该需求的 `design.md`。

package/templates/entries/spec/CLAUDE.md

@@ -1,5 +1,5 @@
-# spec/
-
-**Always read [AGENTS.md](./AGENTS.md) in this directory before working under `spec/`.**
-
-`spec/AGENTS.md` defines the S1 node map, the INDEX derivation table, and the post-write INDEX sync rule (R1).
+# spec/
+
+**Always read [AGENTS.md](./AGENTS.md) in this directory before working under `spec/`.**
+
+`spec/AGENTS.md` defines the S1 node map, the INDEX derivation table, and the post-write INDEX sync rule (R1).

package/templates/entries/spec/INDEX.md

@@ -1,28 +1,28 @@
-# spec 索引
-
-## 需求
-
-<!--
-各列怎么填:
-- 需求名:`spec/needs/<需求名>/` 的 kebab 目录名
-- prd / design:对应文件 frontmatter 的 status(draft/active/archived);文件不存在填 -
-- todo:todo.md 的 已勾数/总数(如 5/8,即拆解任务的完成进度);无 todo.md 填 -。这是 A5 内部子进度,不是节点位次(节点看「当前节点」列)
-- issues:该需求 issues/ 下文件数 + 是否有未结(如 0 / 1 active);无则 -
-- 当前节点:由文件状态推导得出,不手编(推导规则见 spec/AGENTS.md「INDEX 推导规则」)
--->
-
-| 需求名 | prd | design | todo | issues | 当前节点 |
-|--------|-----|--------|------|--------|----------|
-
-## ADR
-
-<!-- 编号 4 位 / 状态 proposed|accepted|superseded / 日期,均取自各 ADR frontmatter(详见 spec/ADR/AGENTS.md) -->
-
-| 编号 | 标题 | 状态 | 日期 |
-|------|------|------|------|
-
-## 跨需求引用
-
-<!-- 从各 prd/design frontmatter 的 related-needs 聚合 -->
-
-- 暂无
+# spec 索引
+
+## 需求
+
+<!--
+各列怎么填:
+- 需求名:`spec/needs/<需求名>/` 的 kebab 目录名
+- prd / design:对应文件 frontmatter 的 status(draft/active/archived);文件不存在填 -
+- todo:todo.md 的 已勾数/总数(如 5/8,即拆解任务的完成进度);无 todo.md 填 -。这是 A5 内部子进度,不是节点位次(节点看「当前节点」列)
+- issues:该需求 issues/ 下文件数 + 是否有未结(如 0 / 1 active);无则 -
+- 当前节点:由文件状态推导得出,不手编(推导规则见 spec/AGENTS.md「INDEX 推导规则」)
+-->
+
+| 需求名 | prd | design | todo | issues | 当前节点 |
+|--------|-----|--------|------|--------|----------|
+
+## ADR
+
+<!-- 编号 4 位 / 状态 proposed|accepted|superseded / 日期,均取自各 ADR frontmatter(详见 spec/ADR/AGENTS.md) -->
+
+| 编号 | 标题 | 状态 | 日期 |
+|------|------|------|------|
+
+## 跨需求引用
+
+<!-- 从各 prd/design frontmatter 的 related-needs 聚合 -->
+
+- 暂无

package/templates/entries/spec/README.md

@@ -1,23 +1,23 @@
-# Spec Map
-
-> 给人看:回忆"项目长什么样"。以 ASCII 图为主,可省细节、突出全貌。**README ≠ INDEX 镜像**——INDEX 给模型看进度,这里给人看全貌。
-
-## Needs
-
-```text
-TODO: 用 ASCII 图画出需求地图。
-```
-
-## Main Flow
-
-```text
-TODO: 用 ASCII 图画出核心业务流程。
-```
-
-> 全局架构总览画在这里(而非写进某个需求的 design.md)。
-
-## Relationships
-
-```text
-TODO: 按需记录需求间依赖或触发关系。
-```
+# Spec Map
+
+> 给人看:回忆"项目长什么样"。以 ASCII 图为主,可省细节、突出全貌。**README ≠ INDEX 镜像**——INDEX 给模型看进度,这里给人看全貌。
+
+## Needs
+
+```text
+TODO: 用 ASCII 图画出需求地图。
+```
+
+## Main Flow
+
+```text
+TODO: 用 ASCII 图画出核心业务流程。
+```
+
+> 全局架构总览画在这里(而非写进某个需求的 design.md)。
+
+## Relationships
+
+```text
+TODO: 按需记录需求间依赖或触发关系。
+```