add-coder 0.1.0

package/templates/core/templates/review-runtime-template.schema.json

@@ -0,0 +1,47 @@
+{
+    "template": "review-runtime-template.md",
+    "sections": [
+        {
+            "id": "meta",
+            "heading": "## Review 元信息",
+            "required": true
+        },
+        {
+            "id": "findings",
+            "heading": "## 1. 发现列表",
+            "required": true
+        },
+        {
+            "id": "improvements",
+            "heading": "## 2. review 流程改进项",
+            "required": true
+        },
+        {
+            "id": "fixed",
+            "heading": "## 3. 已运行时修复项",
+            "required": false
+        },
+        {
+            "id": "feedback",
+            "heading": "## 4. 回流确认",
+            "required": true
+        }
+    ],
+    "placeholders": [
+        "{标题}",
+        "{前置方案 review 文档路径}",
+        "{前置实现 review 文档路径}",
+        "{前置 checklist 文档路径}",
+        "{YYYY-MM-DD}",
+        "{用户报告",
+        "{问题标题}",
+        "{N}",
+        "{hash}",
+        "{日期}",
+        "{提交信息}"
+    ],
+    "forbidden_terms": [ "Phase", 
+        "阶段",
+        "步骤"
+    ]
+}

package/templates/core/templates/review-template.md

@@ -0,0 +1,37 @@
+# {标题}
+
+## Review 元信息
+
+- **Review 对象**: {被评审的 spec / 设计 / 方案}
+- **对比方案**: {方案 A vs 方案 B（可选）}
+- **Review 时间**: {YYYY-MM-DD}
+- **Review 类型**: {架构决策 / 方案选型 / 合规检查}
+- **前置阅读**: {关联的 plan / spec / handoff}
+
+---
+
+## 1. 问题复现
+
+为什么需要这次评审？
+
+---
+
+## 2. 方案对比（如有多个方案）
+
+### 2.1 方案 A
+
+### 2.2 方案 B
+
+---
+
+## 3. 决策结论
+
+---
+
+## 4. 影响评估
+
+### 4.1 受影响文件
+
+### 4.2 数据流影响
+
+### 4.3 回滚风险

package/templates/core/templates/review-template.schema.json

@@ -0,0 +1,42 @@
+{
+    "template": "review-template.md",
+    "sections": [
+        {
+            "id": "meta",
+            "heading": "## Review 元信息",
+            "required": true
+        },
+        {
+            "id": "problem",
+            "heading": "## 1. 问题复现",
+            "required": true
+        },
+        {
+            "id": "compare",
+            "heading": "## 2. 方案对比",
+            "required": false
+        },
+        {
+            "id": "conclusion",
+            "heading": "## 3. 决策结论",
+            "required": true
+        },
+        {
+            "id": "impact",
+            "heading": "## 4. 影响评估",
+            "required": true
+        }
+    ],
+    "placeholders": [
+        "{标题}",
+        "{被评审的 spec",
+        "{方案 A vs 方案 B",
+        "{YYYY-MM-DD}",
+        "{架构决策",
+        "{关联的 plan"
+    ],
+    "forbidden_terms": [ "Phase", 
+        "阶段",
+        "步骤"
+    ]
+}

package/templates/core/templates/runtime-report-template.md

@@ -0,0 +1,73 @@
+# {项目名} 运行时报告 — {subsystem}
+
+> `{subsystem}` 子系统运行时异常报告。由对应子系统自动追加。
+> 属于 `{{projectName}}-runtime-report/` 体系，与静态 Reports 双向联动。
+
+## 报告元信息
+
+- **子系统**: `{subsystem}`
+- **来源**: `{写入函数或模块}`
+- **首次生成**: {YYYY-MM-DD}
+- **触发方式**: {触发条件描述}
+
+---
+
+## 1. 发现列表
+
+> 尚无运行时发现。对应异常触发后将自动填充。
+
+---
+
+## 2. 发现条目格式
+
+（以下为 `appendRuntimeFinding()` 等自动追加的条目格式，仅供参考）
+
+### 发现: {简短描述}
+
+**时间**：{ISO 8601 时间戳}
+**来源**：`{proxy | route | 其他}`
+**错误**：{错误信息}
+
+**合约断裂点**（如有）：
+
+- 期望：`{期望行为}`
+- 实际：`{实际行为}`
+
+**请求信息**：
+
+- Method: {GET | POST | PUT | DELETE}
+- Path: {请求路径}
+
+**堆栈**：
+
+```
+{stack trace 前 5 行}
+```
+
+---
+
+## 3. 统计数据
+
+| 指标 | 值 |
+|------|:--:|
+| 发现总数 | {n} |
+| 去重后独立发现 | {n} |
+| 已关联 Report Issue | {n} |
+| 已修复（运行时验证） | {n} |
+
+---
+
+## 4. 关联 Report Issue
+
+> 每条发现经人工 triage 后可关联到 `combined-report.md` 中的 Issue。
+
+| 发现 | Report Issue | 状态 |
+|------|-------------|:----:|
+| {发现描述} | `RPT-{id}` | ✅ 已验证 / ❌ 回退 |
+
+---
+
+## 5. 回流确认
+
+- [ ] 重大发现已写入 `combined-report.md`
+- [ ] 修复项已记录 AuditLog

package/templates/core/templates/runtime-report-template.schema.json

@@ -0,0 +1,48 @@
+{
+    "template": "runtime-report-template.md",
+    "sections": [
+        {
+            "id": "meta",
+            "heading": "## 报告元信息",
+            "required": true
+        },
+        {
+            "id": "findings",
+            "heading": "## 1. 发现列表",
+            "required": true
+        },
+        {
+            "id": "format",
+            "heading": "## 2. 发现条目格式",
+            "required": false
+        },
+        {
+            "id": "stats",
+            "heading": "## 3. 统计数据",
+            "required": true
+        },
+        {
+            "id": "linked",
+            "heading": "## 4. 关联 Report Issue",
+            "required": false
+        },
+        {
+            "id": "feedback",
+            "heading": "## 5. 回流确认",
+            "required": true
+        }
+    ],
+    "placeholders": [
+        "{项目名}",
+        "{subsystem}",
+        "{写入函数或模块}",
+        "{YYYY-MM-DD}",
+        "{触发条件描述}",
+        "{n}",
+        "{发现描述}"
+    ],
+    "forbidden_terms": [ "Phase", 
+        "阶段",
+        "步骤"
+    ]
+}

package/templates/core/templates/simple-plan-template.md

@@ -0,0 +1,166 @@
+# {需求名}-plan-v{版本号}
+
+> 精简版 Plan 模板：适用于单一聚焦改动（配置收敛、重构、修复等）。Tasks 合并于 Plan 体，无需独立 spec 文件。
+
+**创建时间**: {ISO 时间戳}
+**主导 AI**: {AI 助手标识}
+
+---
+
+## 一、Plan 概述
+
+- **现状**: 一句话描述当前问题
+- **目标**: 一句话描述改后状态
+- **核心原则**: 本次改动遵循的关键约束
+
+---
+
+## 二、变更范围
+
+### 2.1 涉及文件
+
+| 文件 | 改动类型 | 说明 |
+|------|---------|------|
+| `path/to/file.ts` | 修改 | 一句话说明 |
+
+### 2.2 关键设计决策
+
+1. xxx
+2. xxx
+
+---
+
+## 三、Tasks（合并在 Plan 中，无需独立 spec/tasks.md）
+
+> 单轮 Plan，Task 扁平排列无需分组。依赖关系见 §4.6 执行 Task 摘要。
+
+- [ ] Task 1: {任务描述}
+  - [ ] SubTask 1.1: {子任务描述}
+- [ ] Task 2: {任务描述}
+
+---
+
+## 四、Handoff
+
+> 与独立 `handoff-single-round-template.md` 结构一致。
+
+### 4.1 交接前状态
+
+{描述当前数据/文件分布、系统现状}
+
+### 4.2 交接后状态（目标）
+
+{描述目标布局、变更完成后的系统状态}
+
+### 4.3 改动清单
+
+| # | 文件 | 操作 | 内容 |
+|---|------|------|------|
+| 1 | `{文件路径}` | 新建/修改/删除 | 一句话描述 |
+
+### 4.4 回滚方案
+
+```bash
+git reset --hard <commit>
+```
+
+### 4.5 执行前置检查
+
+- [ ] {检查项1}
+- [ ] {检查项2}
+- [ ] `npx tsc --noEmit` 当前无错误（或已知错误与本变更无关）
+
+### 4.6 执行 Task 摘要
+
+```text
+{依赖图 — ASCII 图，│ ├ ▼ 表达依赖关系}
+
+Step 1 ── {描述}
+            │
+            ▼
+Step 2 ── {描述}
+```
+
+### 4.7 关键风险点
+
+| 风险 | 影响 | 缓解 |
+|------|------|------|
+| {风险描述} | {影响说明} | {缓解措施} |
+
+### 4.8 恢复上下文审计查询（新 AI Session 首次启动必读）
+
+> **给后续 AI 助手的说明**：以下每个 `query_audit_logs(...)` 都是 MCP 工具调用，AI 助手在自己的对话中**直接复制粘贴这些参数调用工具即可**，不需要写 SQL。共 {N} 条审计记录可恢复完整开发上下文。
+
+#### 总体一键恢复
+
+```text
+query_audit_logs({ keyword: "{汇总关键词}" })
+```
+→ 预期返回 {N} 条记录
+
+#### 逐任务/逐文件审计查询
+
+```text
+query_audit_logs({ targetId: "{文件路径1}" })
+→ 预期返回 {ACTION_1}: {描述}
+
+query_audit_logs({ targetId: "{文件路径2}" })
+→ 预期返回 {ACTION_2}: {描述}
+
+query_audit_logs({ keyword: "{ACTION_3}" })
+→ 预期返回 {N} 条: {描述}
+```
+
+#### SQL 管理员验证
+
+```sql
+SELECT action, "targetType", "targetId", reason, "createdAt"
+FROM "AuditLog"
+WHERE action IN (
+  '{ACTION_1}',
+  '{ACTION_2}',
+  '{ACTION_3}'
+)
+ORDER BY "createdAt" DESC;
+```
+
+#### 恢复判定标准
+
+- action 命中数 ≥ {N}
+- grep 验证命令：
+
+```bash
+grep -R "{关键字}" .qoder/
+```
+
+### 4.9 后置确认
+
+- [ ] `npx tsc --noEmit` 通过
+- [ ] {确认项2}
+- [ ] {确认项3}
+
+### 4.10 脱敏要求
+
+Handoff 文档中 **禁止出现** 以下硬编码值：
+- 数据库密码（`POSTGRES_PASSWORD`）
+- Chroma auth token（`CHROMA_AUTH_TOKEN`）
+- JWT 密钥（`JWT_SECRET`）
+- API Key（`OPENAI_API_KEY_*`、`LLM_API_KEY` 等）
+
+所有凭据值应通过 `${ENV_VAR}` 引用，并标注值见 `.env.development`。
+
+---
+
+## 五、验收标准
+
+- [ ] 标准1
+- [ ] 标准2
+
+---
+
+## 六、关联
+
+| 类型 | 路径 |
+|------|------|
+| Handoff | 见本文第四部分 |
+| Review | `.qoder/reviews/{name}-review-v{版本}.md` |

package/templates/core/templates/simple-plan-template.schema.json

@@ -0,0 +1,109 @@
+{
+    "template": "simple-plan-template.md",
+    "sections": [
+        {
+            "id": "overview",
+            "heading": "## 一、Plan 概述",
+            "required": true
+        },
+        {
+            "id": "changes",
+            "heading": "## 二、变更范围",
+            "required": true
+        },
+        {
+            "id": "tasks",
+            "heading": "## 三、Tasks",
+            "required": true
+        },
+        {
+            "id": "handoff",
+            "heading": "## 四、Handoff",
+            "required": true,
+            "subsections": [
+                {
+                    "id": "4.1",
+                    "heading": "### 4.1 交接前状态"
+                },
+                {
+                    "id": "4.2",
+                    "heading": "### 4.2 交接后状态（目标）"
+                },
+                {
+                    "id": "4.3",
+                    "heading": "### 4.3 改动清单"
+                },
+                {
+                    "id": "4.4",
+                    "heading": "### 4.4 回滚方案"
+                },
+                {
+                    "id": "4.5",
+                    "heading": "### 4.5 执行前置检查"
+                },
+                {
+                    "id": "4.6",
+                    "heading": "### 4.6 执行 Task 摘要"
+                },
+                {
+                    "id": "4.7",
+                    "heading": "### 4.7 关键风险点"
+                },
+                {
+                    "id": "4.8",
+                    "heading": "### 4.8 恢复上下文审计查询",
+                    "subsubsections": [
+                        "#### 总体一键恢复",
+                        "#### 逐任务/逐文件审计查询",
+                        "#### SQL 管理员验证",
+                        "#### 恢复判定标准"
+                    ]
+                },
+                {
+                    "id": "4.9",
+                    "heading": "### 4.9 后置确认"
+                },
+                {
+                    "id": "4.10",
+                    "heading": "### 4.10 脱敏要求"
+                }
+            ]
+        },
+        {
+            "id": "acceptance",
+            "heading": "## 五、验收标准",
+            "required": true
+        },
+        {
+            "id": "references",
+            "heading": "## 六、关联",
+            "required": true
+        }
+    ],
+    "placeholders": [
+        "{需求名}",
+        "{版本号}",
+        "{ISO 时间戳}",
+        "{AI 助手标识}",
+        "{文件路径}",
+        "{新建/修改/删除}",
+        "{检查项1}",
+        "{检查项2}",
+        "{描述}",
+        "{风险描述}",
+        "{影响说明}",
+        "{缓解措施}",
+        "{汇总关键词}",
+        "{N}",
+        "{关键字}",
+        "{ACTION_1}",
+        "{ACTION_2}",
+        "{ACTION_3}"
+    ],
+    "forbidden_terms": [ "Phase", 
+        "Round",
+        "轮次",
+        "阶段",
+        "步骤"
+    ]
+}

package/templates/core/templates/spec-template.md

@@ -0,0 +1,22 @@
+# {功能名称} Spec
+
+## Why
+
+为什么需要这个变更。
+
+## What Changes
+
+变更内容。
+
+## Impact
+
+影响范围。
+
+## ADDED Requirements
+
+### Requirement: {需求名称}
+
+#### Scenario: {场景名称}
+
+- **WHEN** {条件}
+- **THEN** {结果}

package/templates/core/templates/spec-template.schema.json

@@ -0,0 +1,41 @@
+{
+    "template": "spec-template.md",
+    "sections": [
+        {
+            "id": "why",
+            "heading": "## Why",
+            "required": true
+        },
+        {
+            "id": "what",
+            "heading": "## What Changes",
+            "required": true
+        },
+        {
+            "id": "impact",
+            "heading": "## Impact",
+            "required": true
+        },
+        {
+            "id": "boundaries",
+            "heading": "## Boundaries",
+            "required": false
+        },
+        {
+            "id": "requirements",
+            "heading": "## Requirements",
+            "required": true
+        }
+    ],
+    "placeholders": [
+        "{功能名称}",
+        "{描述}"
+    ],
+    "forbidden_terms": [
+        "Phase",
+        "Step",
+        "Task",
+        "阶段",
+        "步骤"
+    ]
+}

package/templates/core/templates/standard-plan-template.md

@@ -0,0 +1,96 @@
+# {需求域名}-{核心内容}-plan-v{版本号}
+
+> **Plan/Spec 边界提醒**：Plan 回答"改什么、为什么改、改哪里"——写到让 Review 能判断方向对不对、有没有遗漏维度的程度（文件路径 + Task 验收标准 + 架构维度全覆盖）。**不要**在 Plan 中写完整 TS 类型定义、WHEN-THEN 场景、精确函数签名——那是 Spec 的职责。详见 [《ADD开发工作路径与文档协同规范》§8.1.1]({{projectRoot}}/{{docsDir}}/knowledge/01-架构/《ADD开发工作路径与文档协同规范》.md)。
+
+## PLAN 元信息
+
+- **Plan 名称**: {英文名}-{序号}
+- **启动时间**: {ISO 时间戳}
+- **主导 AI**: {AI 助手标识}
+- **关联文档**:
+  - ADD Route: `.qoder/plans/{YYYY-MM}/{DD}/{需求域名}-{核心内容}-add-route-v{版本}.md`
+  - Handoff: `.qoder/plans/{YYYY-MM}/{DD}/{需求域名}-{核心内容}-handoff-v{版本}.md`
+  - Review: `.qoder/reviews/{需求域名}-review-v{版本}.md`
+- **ADD-7 审计策略**:
+
+| 文件 | targetType | action | beforeState | afterState | 状态 |
+|-----|-----------|--------|------------|-----------|------|
+| path/to/file.ts | COMPONENT | COMPONENT_CREATED | 描述改前状态 | 描述改后状态 | 待实施 |
+
+---
+
+## 一、背景与目标
+
+### 1.1 问题现状
+
+### 1.2 目标
+
+---
+
+## 二、方案选型（如有多个候选方案）
+
+### 2.1 候选方案对比
+
+| 方案 | 因素1 | 因素2 | 因素3 | 结论 |
+|------|-------|-------|-------|------|
+| A: xxx | | | | |
+| B: xxx | | | | |
+
+### 2.2 选型理由
+
+---
+
+## 三、架构设计
+
+### 3.1 数据流转（文件级，标注关键行号与回退路径）
+
+```
+{自上而下的数据流转 ASCII 图，│ ├ ▼ 表达流向，标注文件路径与行号}
+{必须包含完整的回退链：每一步失败后的降级路径}
+```
+
+### 3.2 {架构图表 / 拓扑 / 组件关系（可选）}
+
+### 3.3 {数据模型变更（如有）}
+
+---
+
+## 四、实施 Task + 依赖图
+
+```
+Task 1 ──┐
+          │ 可并行
+Task 2 ──┘
+          │
+          ▼
+Task 3 ──┐
+Task 4 ──┤ 可并行
+Task 5 ──┘
+          │
+          ▼
+Task 6 (编译/测试)
+```
+
+### Step 0: 文档先行
+
+### Step N: ...
+
+---
+
+## 五、验收标准
+
+- [ ] 标准1
+- [ ] 标准2
+
+---
+
+## 六、关联文档
+
+| 文档 | 路径 |
+|------|------|
+| ADD Route | `.qoder/plans/...` |
+| Handoff | `.qoder/plans/...` |
+| Review | `.qoder/reviews/...` |
+| Spec | `.qoder/specs/{name}/spec.md` |
+| Tasks | `.qoder/specs/{name}/tasks.md` |
+| Checklist | `.qoder/specs/{name}/checklist.md` |