npm - create-yss-spec - Versions diffs - 3.4.10 → 3.5.2 - Mend

create-yss-spec 3.4.10 → 3.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (642) hide show

package/template/docs/design/preview.html DELETED Viewed

@@ -1,178 +0,0 @@
-<!doctype html>
-<html lang="zh-CN">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <meta name="theme-color" content="#f0f2f5">
-  <title>YSS Design System · Compact Preview</title>
-  <link rel="stylesheet" href="./preview.css">
-</head>
-<body>
-  <main class="app-shell">
-    <header class="page-heading">
-      <div class="page-title-group">
-        <div class="eyebrow">YSS DESIGN SYSTEM</div>
-        <div class="title-line">
-          <h1>组件与状态预览</h1>
-          <span class="density-chip">默认模式 · 32px</span>
-        </div>
-        <p class="page-description">Ant Design v6 语义 Token · YSS 项目主题覆盖</p>
-      </div>
-      <div class="heading-actions">
-        <nav class="mode-switch" aria-label="主题预览">
-          <a href="./preview.html" aria-current="page">明亮</a>
-          <a href="./preview-dark.html">暗色</a>
-        </nav>
-        <button class="button button-primary" type="button" data-primary-action>保存规范</button>
-        <button class="button" type="button" disabled title="当前没有待提交的变更">提交</button>
-      </div>
-    </header>
-    <section class="panel" aria-labelledby="filter-title">
-      <div class="panel-heading">
-        <div>
-          <div class="panel-title-row">
-            <h2 id="filter-title">任务筛选</h2>
-            <span class="panel-description">保持单行扫描，空间不足时按字段组换行</span>
-          </div>
-        </div>
-        <span class="count-chip" data-count>3 条记录</span>
-      </div>
-      <div class="panel-body">
-        <form class="toolbar" data-filter-form>
-          <div class="field field-keyword">
-            <label for="keyword">任务名称</label>
-            <input id="keyword" class="control" type="search" placeholder="输入名称或编号" data-keyword>
-          </div>
-          <div class="field field-status">
-            <label for="status">运行状态</label>
-            <select id="status" class="control" data-status>
-              <option value="all">全部状态</option>
-              <option value="success">已完成</option>
-              <option value="processing">处理中</option>
-              <option value="error">失败</option>
-            </select>
-          </div>
-          <div class="toolbar-actions">
-            <button class="button button-text" type="button" data-reset>重置</button>
-            <button class="button button-primary" type="submit">查询</button>
-          </div>
-        </form>
-        <div class="notice notice-info filter-feedback" role="status">
-          <span>默认模式保留 14px 正文，以 32px 控件、8px 控件间距和 12px 区域节奏提升扫描效率。</span>
-        </div>
-      </div>
-    </section>
-    <section class="panel" aria-labelledby="table-title">
-      <div class="panel-heading">
-        <div class="panel-title-row">
-          <h2 id="table-title">任务列表</h2>
-          <span class="panel-description">状态使用浅色语义面，不使用高饱和整块填充</span>
-        </div>
-        <div class="table-actions">
-          <button class="button" type="button">导出</button>
-          <button class="button button-primary" type="button" data-dialog-trigger>新建任务</button>
-        </div>
-      </div>
-      <div class="table-wrap">
-        <table>
-          <colgroup>
-            <col style="width:34%">
-            <col style="width:16%">
-            <col style="width:16%">
-            <col style="width:20%">
-            <col style="width:14%">
-          </colgroup>
-          <thead>
-            <tr>
-              <th scope="col">名称</th>
-              <th scope="col">状态</th>
-              <th scope="col">责任人</th>
-              <th scope="col">更新时间</th>
-              <th scope="col">操作</th>
-            </tr>
-          </thead>
-          <tbody>
-            <tr data-record data-status="success" data-search="示例任务 yss-1024" aria-selected="true">
-              <td><span class="cell-main">示例任务</span><span class="cell-sub">YSS-1024 · 设计系统核验</span></td>
-              <td><span class="status-label status-success" data-row-status>已完成</span></td>
-              <td>陈墨</td>
-              <td>2026-09-02 09:30</td>
-              <td><button class="link-action" type="button">查看</button></td>
-            </tr>
-            <tr data-record data-status="processing" data-search="加载中的任务 yss-1025">
-              <td><span class="cell-main">加载中的任务</span><span class="cell-sub">YSS-1025 · Token 同步</span></td>
-              <td><span class="status-label status-processing" data-row-status>处理中</span></td>
-              <td>林晓</td>
-              <td>刚刚</td>
-              <td><button class="link-action" type="button" disabled>编辑</button></td>
-            </tr>
-            <tr data-record data-status="error" data-search="失败任务 yss-1026">
-              <td><span class="cell-main">失败任务</span><span class="cell-sub">YSS-1026 · 权限快照</span></td>
-              <td><span class="status-label status-error" data-row-status>权限不足</span></td>
-              <td>周屿</td>
-              <td>2026-09-02 08:46</td>
-              <td><button class="link-action" type="button" data-retry>重试</button></td>
-            </tr>
-            <tr data-empty-row hidden>
-              <td colspan="5"><span class="muted">没有符合当前筛选条件的任务。</span></td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-    </section>
-    <div class="support-grid">
-      <section class="panel" aria-labelledby="feedback-title">
-        <div class="panel-heading">
-          <h2 id="feedback-title">语义反馈</h2>
-          <span class="panel-description">颜色、边框与文本共同传达状态</span>
-        </div>
-        <div class="panel-body">
-          <div class="notice notice-success"><span>配置已同步，可进入下一步核验。</span></div>
-          <div class="notice notice-warning"><span>有 2 项变更等待维护者确认。</span></div>
-          <div class="notice notice-error" role="alert"><span>权限快照失败，请检查访问范围后重试。</span></div>
-        </div>
-      </section>
-      <section class="panel" aria-labelledby="empty-title">
-        <div class="panel-heading">
-          <h2 id="empty-title">空状态与无障碍</h2>
-          <span class="panel-description">下一步明确、焦点可见</span>
-        </div>
-        <div class="panel-body">
-          <div class="empty-state">
-            <div>
-              <p class="empty-title">暂无草稿</p>
-              <p class="muted">创建后即可验证 Modal、键盘焦点与操作反馈。</p>
-            </div>
-            <button class="button" type="button" data-dialog-trigger>创建草稿</button>
-          </div>
-          <ul class="check-list" aria-label="无障碍检查项">
-            <li>Tab 顺序符合视觉阅读顺序</li>
-            <li>200% 缩放时只有表格容器横向滚动</li>
-          </ul>
-        </div>
-      </section>
-    </div>
-  </main>
-  <dialog class="dialog" data-dialog aria-labelledby="dialog-title">
-    <div class="dialog-header">
-      <h2 id="dialog-title">创建任务草稿</h2>
-      <button class="dialog-close" type="button" aria-label="关闭弹窗" data-dialog-close>关闭</button>
-    </div>
-    <div class="dialog-body">
-      <p>草稿只保存当前页面配置，不会触发正式发布或外部副作用。</p>
-    </div>
-    <div class="dialog-footer">
-      <button class="button" type="button" data-dialog-close>取消</button>
-      <button class="button button-primary" type="button" data-dialog-close>确认创建</button>
-    </div>
-  </dialog>
-  <div class="visually-hidden" aria-live="polite" data-live></div>
-  <script src="./preview.js"></script>
-</body>
-</html>

package/template/docs/design/preview.js DELETED Viewed

@@ -1,71 +0,0 @@
-const root = document.documentElement;
-const filterForm = document.querySelector("[data-filter-form]");
-const keywordInput = document.querySelector("[data-keyword]");
-const statusSelect = document.querySelector("[data-status]");
-const resetButton = document.querySelector("[data-reset]");
-const primaryButton = document.querySelector("[data-primary-action]");
-const count = document.querySelector("[data-count]");
-const emptyRow = document.querySelector("[data-empty-row]");
-const dialog = document.querySelector("[data-dialog]");
-const dialogTriggers = document.querySelectorAll("[data-dialog-trigger]");
-const dialogCloseButtons = document.querySelectorAll("[data-dialog-close]");
-const liveRegion = document.querySelector("[data-live]");
-const dataRows = [...document.querySelectorAll("tbody tr[data-record]")];
-function announce(message) {
-  liveRegion.textContent = message;
-}
-function applyFilters() {
-  const keyword = keywordInput.value.trim().toLowerCase();
-  const status = statusSelect.value;
-  let visible = 0;
-  dataRows.forEach((row) => {
-    const matchesKeyword = !keyword || row.dataset.search.includes(keyword);
-    const matchesStatus = status === "all" || row.dataset.status === status;
-    const matches = matchesKeyword && matchesStatus;
-    row.hidden = !matches;
-    if (matches) visible += 1;
-  });
-  count.textContent = `${visible} 条记录`;
-  emptyRow.hidden = visible !== 0;
-  announce(`筛选完成，共 ${visible} 条记录`);
-}
-filterForm.addEventListener("submit", (event) => {
-  event.preventDefault();
-  applyFilters();
-});
-resetButton.addEventListener("click", () => {
-  keywordInput.value = "";
-  statusSelect.value = "all";
-  applyFilters();
-  keywordInput.focus();
-  announce("筛选条件已重置");
-});
-primaryButton.addEventListener("click", () => {
-  const completedLabel = root.classList.contains("dark") ? "已发布" : "已保存";
-  primaryButton.textContent = completedLabel;
-  primaryButton.disabled = true;
-  announce(`${completedLabel}，操作已完成`);
-});
-dialogTriggers.forEach((button) => button.addEventListener("click", () => dialog.showModal()));
-dialogCloseButtons.forEach((button) => button.addEventListener("click", () => dialog.close()));
-document.querySelectorAll("[data-retry]").forEach((button) => {
-  button.addEventListener("click", () => {
-    const row = button.closest("tr");
-    const status = row.querySelector("[data-row-status]");
-    row.dataset.status = "processing";
-    status.className = "status-label status-processing";
-    status.textContent = "处理中";
-    button.textContent = "查看";
-    button.removeAttribute("data-retry");
-    announce("失败任务已重新提交，当前正在处理中");
-  });
-});

package/template/docs/design/prototypes/.gitkeep DELETED Viewed

	@@ -1 +0,0 @@
1	-

package/template/docs/design/tokens/.design-md-projection.json DELETED Viewed

@@ -1,13 +0,0 @@
-{
-  "schema_version": 1,
-  "source": "DESIGN.md",
-  "source_sha256": "e84a6c175840efe9663a2d0aba37f5635c053f47452bb146d1025d65665b1bec",
-  "files": {
-    "docs/design/tokens/theme.json": "740f80c2c55763564ac5e1cf4159e0d5f0965548d53e0eb0de0ff380e74f0a93",
-    "docs/design/tokens/tokens.default.json": "4e6446ee85195e3a75676a763cb8be2c625dc86b2b0676cbc8b45b2221135a71",
-    "docs/design/tokens/tokens.dark.json": "826391c5dafaef4d924003052bcfa9b38943e589120b0ff740214a12c9981ae1",
-    "docs/design/tokens/tokens.compact.json": "1a943c1354487addc67e399ededc122337d278a9ff61cb12d36a2f8202e26d9c",
-    "docs/design/tokens/variables.css": "028c24f9e935f5c4b1392d131a4cd13482e6572a2ced4360ffa833aa3fbeaf66",
-    "docs/design/tokens/variables.dark.css": "38132db701cd1e9793b6320baba20645a2cf577edc75b25aadb211f65bf05767"
-  }
-}

package/template/docs/implementation/.gitkeep DELETED Viewed

	@@ -1 +0,0 @@
1	-

package/template/docs/plan/IDEATION.md DELETED Viewed

@@ -1,96 +0,0 @@
-# 机会构想 (Ideation) — 发现与需求之间的假设生成
-> **Plan 内部方法：生成可验证假设，再用 事实核查 事实校准。AI 是发散、挑战和组合机会的加速器。**
----
-## 定位：机会探索环中的假设生成
-Ideation 不等同于  Matt skills `需求澄清`：
-| 项 | 定位 | 输出 |
-|---|---|---|
-| Ideation Agent | 产品机会探索角色，回答“可能做什么、是否值得探索” | 候选机会、假设、挑战点、组合方案 |
-| 事实核查角色 | 事实验证角色，回答“证据支持什么、用户真实痛点是什么” | 市场、竞品、用户洞察、MVP 边界输入 |
-|  Matt skills `需求澄清` | 方法论 skill，回答“某个已选方向如何形成技术方案” | 设计说明、方案取舍、风险识别、进入计划前的批准点 |
-推荐关系：
-```text
-市场 / 竞品 / 用户事实 <-> 机会构想假设 <-> MVP 边界
-```
-如果只有一个模糊主题，可以先 Ideation 再 事实核查；如果已经有竞品、用户或行业材料，应先 事实核查 再 Ideation。二者循环到 Spec 前，必须收敛用户、痛点、做什么、不做什么和成功标准。
----
-## AI 在机会构想中的四种角色
-### 1. 发散者 — 产生大量想法
-```python
-delegate_task(
-    goal="对'[主题]'做机会构想，至少产生 30 个候选机会",
-    context="""
-    不要过滤。不讨论可行性。数量优先。
-    思考维度：功能/体验/运营/技术/商业模式
-    输出：30+ 个候选机会，每个一句话 + 维度标签
-    """
-)
-```
-### 2. 挑战者 — 魔鬼代言人
-```python
-delegate_task(
-    goal="对这 5 个候选机会，站在反对者角度逐一挑战",
-    context="对每个候选机会：用户为什么不买账？技术上最大的坑？竞品失败过吗？"
-)
-```
-### 3. 连接者 — 发现模式
-```python
-delegate_task(
-    goal="分析 30 个候选机会，找出隐藏的模式和可组合的机会",
-    context="归类为 5-7 个主题 / 识别可组合的 / 标注低垂果实 vs 登月计划"
-)
-```
-### 4. 记录者 — 结构化输出
-```python
-delegate_task(
-    goal="将机会构想输出整理为结构化文档",
-    context="按主题分类 + 假设-证据-风险矩阵 + Top 5 + Next Steps"
-)
-```
----
-## 方法库
-### How Might We (HMW)
-```
-用户痛点 → "我们如何..." → 针对每个 HMW 产生想法
-```
-### Crazy 8s
-```
-8 分钟画 8 个方案草图 → 投票选出最佳
-```
-### SCAMPER
-```
-Substitute / Combine / Adapt / Modify / Put to another use / Eliminate / Reverse
-```
----
-## AI-Human Loop
-```
-人类提主题或 事实核查 事实 → AI 发散候选机会 → 人类选择 Top 10
-→ AI 挑战者分析 → 事实核查 验证证据 → AI 连接者找模式
-→ 收敛 MVP 边界 → 确认是否进入 Spec / Ticket 或  Matt skills 需求澄清 技术方案设计
-```

package/template/docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md DELETED Viewed

@@ -1,13 +0,0 @@
-# Matt Pocock Engineering Skills 集成
-Matt Pocock Engineering Skills 提供轻量的澄清、实现、TDD、诊断和审查方法；YSS 生命周期、仓库身份、产品设计、OpenAPI 和跨仓库契约仍由本模板的权威资产裁决。
-## 进入与退出
-- `triage` 是显式 Issue / PR 兼容入口；普通请求由 `yss-product-lifecycle` 的 `request_triage` 合同处理。其 YSS 适配只回交取证、简报和状态建议；简报不替代批准的切片合同，状态调整由生命周期核验。详细规则见 [请求分诊协议](../../.agents/skills/yss-product-lifecycle/references/request-triage.md)。
-- Matt user-invoked 的 `grill-with-docs`、`to-spec`、`to-tickets` 和 `implement` 必须由用户显式启动，任何 skill 不得自动调用它们；YSS 生命周期只准备、校验和验收其结果。所有 Matt model-invoked skill 仍须遵守 `AGENTS.md` 的阶段、门禁和证据要求，并只能在生命周期允许的工作单元中调用。
-- `code-review` 保持唯一默认审查入口。YSS 适配把 Slice `required_skills`、`alibaba-java-code-style` 与命中的 `yss-ui` / `yss-domain` 等专项 skill 编译为 Standards 检查输入，并要求实现仓已有的 `pnpm` / `./mvnw` 机器检查；禁止再增加第二个通用审查 skill 或专用审查 Cloud 环境来代替这条接线。审查 finding 按编排合同分流：实现者修复后全轴复审，或合同 `stale` 后回 实现合同编译器；审查者不得写实现。
-- `template-source` 只执行模板维护流程，不生成具体产品 Spec、原型、OpenAPI 或垂直切片 Ticket。
-- `code-review` 的 YSS 人员适配：普通功能默认一个独立 Reviewer，分别完成 Standards、Spec 与适用 UI 检查；能力缺口、冲突、外部制度或用户指定时才拆分多审查者。保留检查轴和证据，不将上游并行 Agent 形式转成固定多人会签。
-- Matt 的 `research` 已适配为 canonical `yss-research`，旧名只作为 deprecated alias。YSS 版本提供 `technical-evidence` / `strategy-evidence` profile、`quick` / `evidence-audited` 模式、证据合同和确定性校验，同时保留上游 revision 与原始 hash 以便追溯。
-- Agent 完成工作单元后返回可核验的 evidence refs、变更资产、验证命令、残余风险和下一路由。

package/template/docs/process/PDCA-SCRUM.md DELETED Viewed

@@ -1,10 +0,0 @@
-# PDCA × Scrum × AI
-模板维护和项目实例研发都采用短反馈循环：Plan 明确范围与门禁，Do 执行一个可验证工作单元，Check 运行 fresh verification，Act 回写权威资产和下一步。Scrum 的迭代节奏只影响协作安排，不改变 YSS 生命周期阶段、条件门禁或 Ticket 状态。
-## 使用约束
-- 每个工作单元先确认 `yss-project.yaml` 身份和最近可信阶段。
-- 以垂直切片和公开测试 seam 交付，不按纯技术层横向堆积未验证代码。
-- Check 失败时保留证据并回到最近的阻塞门禁，不以“已执行命令”替代通过结论。
-- Act 只修改单一事实来源，再同步技能投影和派生文档。

package/template/docs/process/github-workflows.md DELETED Viewed

@@ -1,52 +0,0 @@
-# GitHub CI 与发布前验证
-本合同区分模板源、项目实例和实现仓库的验证责任。生命周期门禁仍由 `lifecycle-registry.yaml` 定义；维护分级由 `maintenance-intensity.yaml` 和 `harness-process-tailoring.md` 定义；检查组、影响面和兼容触发路径只在 `template-verification-profiles.yaml` 维护。
-## 模板源
-| 入口 | 行为 | 结果边界 |
-|---|---|---|
-| PR：Template CI | 对合成 merge commit 执行 candidate；以事件 base SHA 计算影响面；核心或未映射路径升级全量 | 合并前机器检查，不宣布发布就绪 |
-| main push：Template CI | Node 24 全量 `scripts/verify-template` | 检查合并后的完整主干 |
-| Template compatibility | 工具影响 PR、main 全量及发布前执行 Node 22 工具测试、macOS vendor 一致性、Node 26 非阻断观察 | 独立于 Node 24 主验证，不再重复主验证中的工具测试 |
-| 手动：Template release verification | 输入完整 40 位模板 commit，精确检出；全量验证、生成器集成与兼容矩阵 | 产出证据，不打 tag、不创建 Release、不发布包 |
-模板工作流首先要求 `template-source`。全量检查初始化验证实际依赖的公开 gitlink 固定子模块，不追踪上游分支；兼容期私有 `yss-harness-dev-agent` 不参与主模板验证，也不要求 GitHub 默认 token 具备跨仓私有读取权限。工具依赖使用固定 pnpm 与 frozen lockfile；Node 24 为主验证环境，Python 3.12 / jsonschema 4.23.0 提供既有 schema 检查依赖。vendor 校验在临时目录重建并比较，不先覆盖受版本管理的 vendor。
-本地复验应把独立 Node 24 的 bin 加入 PATH 后直接运行验证入口；不要用带 `--package` 的 `npm exec` 包住整条验证链，其包配置可能被内部 npx 继承，改变实际执行的工具。
-PR 无工作流级 paths 过滤，始终产生 `Template checks` 汇总结果；兼容检查只有在计划要求时才能跳过。PR 同号的新运行取消旧运行；main 和发布前运行用 run ID 隔离。远程 required checks / 分支保护由仓库维护者配置，本轮不修改远程设置。
-## 发布版本与证据
-`Template release verification` 必须先存在于默认分支。输入 SHA 与实际 HEAD 必须一致；该提交也必须具备本合同对应的脚本和 action。调用工作流的版本与待验证 SHA 可能不同，Actions run 保留编排版本，报告记录被验证版本。
-`node .template-source/scripts/verify-template-release.mjs --commit <40位SHA> --output <仓库外绝对目录>` 要求干净的模板工作树、所有必需子模块已初始化且与 gitlink 一致；仅允许兼容期私有 `yss-harness-dev-agent` 未初始化。全量验证后，从 gitlink 对应的 `create-yss-spec` commit 创建隔离副本，用待发布模板重建快照；打包、干净安装、初始化、Skill 投影/锁校验，以及同步前后用户 `.github` 保留检查必须通过。不会改原始生成器工作树。既有其他专职生成器场景继续由全量 profile 执行。
-生成器消费者验收使用 `npm pack --ignore-scripts` 和本地 tarball 安装，属于包格式验证的受控工具例外；模板工具测试仍用 pnpm。不会执行 npm publish，也不使用浮动生成器版本或 latest 包。
-证据保存在 runner 临时目录，通过 artifact 上传：PR 保留计划、base/head/tested commit 与日志；发布保留 `release-verification.json`、每条命令实际退出码、日志、模板 SHA、生成器 SHA、子模块版本与新快照摘要；兼容 job 分别上传日志。失败时也尝试上传，准备阶段失败或 runner 丢失造成证据缺失时不得宣称通过。最终通过要求全量、集成和阻断兼容 job 均成功；Node 26 观察失败可见但不阻断。
-本地实现验证不等同于已执行 GitHub Actions。正式发布前仍须对实际待发布提交运行以上入口，由维护者明确发起实际发布。
-## 项目实例 CI 合同
-本轮仅定义合同，不安装实例 CI。现有生成器继续排除 `.github`；升级同步不得接管已有工作流。自动安装将作为独立能力处理。
-实例 CI 的后续实现须遵循：
-- 先验证根 `yss-project.yaml` 的 `project-instance` 身份，以及根 `CONTEXT.md` 合同。
-- 只检查已有流程资产的 schema、引用、摘要与状态真实性。Plan、Spec、设计和契约草案允许合入；不存在的未来阶段产物不是失败。
-- 对声称批准或正在流转的工作单元，按生命周期注册表检查其实际门禁、用户决定、当前资产和证据；不能以“草案允许合入”绕过流转条件。
-- 不运行上游技能分发、上游同步、模板生成器回归或模板发布检查，也不要求 `.template-source`、模板子模块或模板维护 checkpoint。
-- 业务构建、单元测试和交付验收归属已登记的实现仓库；按其接入合同引用证据，不在治理实例中猜测业务构建命令。
-## 平台事实依据
-- [GitHub 事件与 PR merge / workflow_dispatch 语义](https://docs.github.com/en/actions/reference/workflows-and-actions/events-that-trigger-workflows)
-- [checkout 的 ref 和子模块选项](https://github.com/actions/checkout#usage)
-- [job outputs](https://docs.github.com/en/actions/how-tos/write-workflows/choose-what-workflows-do/pass-job-outputs)
-- [并发控制](https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax#concurrency)
-- [失败后 artifact 上传及隐藏路径规则](https://github.com/actions/upload-artifact/blob/v4/README.md)
-以上平台语义于 2026-09-10 使用 yss-research technical-evidence / quick 查阅官方文档；验证责任与裁剪策略来自本轮用户确认。

package/template/docs/process/harness-executive-blueprint.md DELETED Viewed

@@ -1,10 +0,0 @@
-# Harness 执行蓝图
-Harness 以仓库身份、影响面、条件门禁和可读证据串联研发流程。执行编排器只推进第一个未阻塞工作单元，并在人工暂停、handoff、实现、合并和发布边界集中回写 checkpoint。
-## 核心约束
-- `template-source` 只维护流程模板，不生成具体产品资产。
-- `project-instance` 必须从最近可信阶段进入，不以目录猜测门禁状态。
-- 命中条件的门禁未通过时，状态保持 blocked 或 needs-human。
-- 没有 fresh verification 和可解析 evidence refs 时，不宣布完成。

package/template/docs/releases/.gitkeep DELETED Viewed

	@@ -1 +0,0 @@
1	-

package/template/docs/requirements/README.md DELETED Viewed

@@ -1,85 +0,0 @@
-# 需求定义 (Requirements) — 从想法到可执行定义
-> **Phase: Requirements | 输入: Plan | 输出: Spec + Stories + 验收条件**
----
-## Engineering Skills 流程
-默认需求链路：
-```text
-grill-with-docs -> to-spec -> API 影响分析 / 契约草案 -> Architecture 反审 -> OpenAPI Freeze -> to-tickets
-```
-进入开发前必须满足：
-- [ ] Spec 使用 [../templates/spec-template.md](../templates/spec-template.md)。
-- [ ] OpenAPI 影响明确为“无”或已产出契约草案 / review-only Draft；进入开发前必须冻结 `docs/.scratch/<feature>/api/<feature>.yaml`。
-- [ ] 测试决策明确主要测试 seam。
-- [ ] AI / 人工审查点标注风险 / 人工确认项。
-- [ ] 后续 Ticket 使用 [../templates/vertical-slice-ticket-template.md](../templates/vertical-slice-ticket-template.md)，不得按层横向拆分。
-Local Markdown 默认将完整功能包保存到 `docs/.scratch/<feature>/`；功能父 Ticket 使用 [../templates/local-parent-ticket-template.md](../templates/local-parent-ticket-template.md)。GitHub / GitLab 只有在项目明确选择时才作为主 tracker。
-## AI 三步法
-### Step 1: 生成 Spec 初稿
-```python
-delegate_task(
-    goal="根据发现报告生成 Spec 初稿",
-    context="""
-    输入：发现报告 (市场+竞品+用户)
-    输出：背景/用户画像/场景/功能需求/NFR/验收条件/边界/技术影响
-    """
-)
-```
-### Step 2: 补充边界场景
-```python
-delegate_task(
-    goal="对 Spec 做边界场景挖掘",
-    context="""
-    从以下角度挖掘遗漏场景：
-    空值/并发/权限/网络异常/数据量极端/时间相关/国际化
-    """
-)
-```
-### Step 3: 拆解用户故事
-```python
-delegate_task(
-    goal="将 Spec 拆解为可估算的用户故事",
-    context="""
-    格式: As a / I want / So that
-    附带 Gherkin 验收条件 + 优先级(P0/P1/P2) + AI风险标注
-    """
-)
-```
----
-## Spec 模板结构
-1. 问题陈述 / 解决方案
-2. 用户故事
-3. 功能需求 / 非功能需求
-4. 验收标准
-5. OpenAPI 影响
-6. 测试决策
-7. AI / 人工审查点
-8. 非目标范围
-9. 风险
----
-## AI-Human Loop
-```
-Plan报告 → AI生成Spec → PM审核
-→ AI补充边界 → PM确认 → AI拆解Stories
-→ 团队估算 → AI标注风险 → TechLead确认 → 进入Architecture
-```

package/template/docs/requirements/tickets/.gitkeep DELETED Viewed

	@@ -1 +0,0 @@
1	-

package/template/docs/templates/agent-brief-template.md DELETED Viewed

@@ -1,46 +0,0 @@
-# Agent Brief：<Ticket 标题>
-> 本简报用于 `ready-for-agent` 状态的垂直切片 Ticket。内容必须足够完整，使 Agent 无需向维护者询问隐藏背景即可开始工作。
-## Ticket 信息
-- 链接：
-- 分类：bug / enhancement
-- 状态：ready-for-agent
-## 背景
-记录已知信息，包括 `CONTEXT.md` 中的相关领域术语，以及约束方案的 ADR。
-## 目标
-Agent 必须交付的可观察行为。
-## 非目标
-Agent 不应修改的范围。
-## 验收标准
-- [ ] 标准 1
-- [ ] 标准 2
-- [ ] 标准 3
-## 实现提示
-- 推荐测试 seam：
-- OpenAPI Draft / Freeze 影响：
-- 相关既有实现：
-## 验证方式
-Agent 应运行的命令或检查：
-```bash
-# 命令
-```
-## 风险与人工审查
-- [ ] 无高风险变更或需人工确认项
-- [ ] 已明确的高风险变更包含对应人工确认项

package/template/docs/templates/architecture-proposal-template.md DELETED Viewed

@@ -1,18 +0,0 @@
----
-pipeline: <feature-id>
-stage: design
-status: draft
-owner: ai
----
-# 架构方案：<功能名称>
-## 背景
-## 备选方案
-## 决策
-## 风险
-## 验证方式

package/template/docs/templates/implementation-plan-template.md DELETED Viewed

@@ -1,16 +0,0 @@
----
-pipeline: <feature-id>
-stage: design
-status: draft
-owner: ai
----
-# 实现计划：<功能名称>
-## 目标
-## 任务拆解
-## 完成定义
-## 验证方式