@elvis1513/auto-coding-skill 0.3.0 → 1.0.1

package/cli/assets/skill/data/templates/docs/tasks/closure-log.md

@@ -0,0 +1,24 @@
+# Closure Log（默认轻量闭环记录：每个任务至少一条）
+
+规则：
+1) 每个任务完成后，至少追加一条闭环记录
+2) 默认记录真实提交、Jenkins、目标环境验证结果
+3) Jenkins 失败后再修复的任务，应补充失败原因和修复提交
+4) 这里是默认闭环文档；长 summary 只用于高风险或复盘任务
+
+---
+
+## <TASK_ID> — <Title> — YYYY-MM-DD HH:MM
+- Task: <TASK_ID>
+- Commit: <commit sha>
+- Jenkins Build: <build url>
+- Target Env: <env name / health url / page path>
+- Verification: <health / key api / key page / business path>
+- Result: PASS / FAIL / PARTIAL
+- Follow-up: <none or todo>
+- Jenkins Failure: <optional>
+- Fix Commit: <optional>
+
+---
+
+继续在下方追加记录（不要删除历史记录）

package/cli/assets/skill/data/templates/docs/tasks/summaries/_TEMPLATE-TASK-SUMMARY.md

@@ -1,5 +1,7 @@
 # Task Summary — <TASK_ID> — <Title>
 
+> 仅用于高风险、跨模块、阶段性里程碑、需要完整复盘的任务。
+
 - Task ID：<TASK_ID>
 - Date：YYYY-MM-DD
 - Scope（本次范围）：
@@ -9,47 +11,22 @@
 
 ## 1. 目标与验收结论
 - 目标：
-- 验收结论：PASS / FAIL（FAIL 必须说明原因与后续计划）
+- 验收结论：PASS / FAIL
 
-## 2. 变更概览（代码/配置/本地运行/Jenkins）
+## 2. 变更概览
 - 关键改动点：
 - 影响模块：
-- 兼容性影响（是否破坏兼容、迁移方案）：
-
-## 3. 接口变更（以 API Markdown 为准）
-- 新增：
-- 修改：
-- 废弃：
-- 变更记录位置：`docs/interfaces/api-change-log.md`（对应条目）
+- 兼容性影响：
 
-## 4. 数据变更（如有）
-- 表/字段变更：
-- 迁移方式：
-- 回滚方式：
+## 3. 质量证据
+- 本地轻量校验：build / test or quick_test / lint / typecheck / api docs / jenkinsfile / diff-check
+- Jenkins Build：
+- 目标环境验证：
+- 闭环记录：`docs/tasks/closure-log.md`
 
-## 5. 质量门禁证据（必须可追溯）
-- 项目配置：`docs/ENGINEERING.md`（frontmatter）
-- 后端测试：`commands.test`
-- 前端构建：`commands.build`
-- 静态分析：`commands.lint`
-- 前端类型检查：`commands.typecheck`
-- Review 文档：`docs/reviews/<TASK_ID>-<timestamp>.md`
-- API 文档：`docs/interfaces/api.md`
-- Jenkins 配置检查：`Jenkinsfile` + `jenkins.*`
-- 回归矩阵：`docs/testing/regression-matrix.md`（全量 PASS，0 fail，且每项必须有真实证据）
-
-## 6. Bug 清单与回归用例
-- 新增/确认的 Bug（写入 `docs/bugs/bug-list.md`）：
-- 新增自动化回归用例（引用回归矩阵ID）：
-
-## 7. 本地运行与 Jenkins 部署记录
-- 本地 Compose 验证：health / smoke / regression 结果
-- Jenkins 部署记录：`docs/deployment/deploy-records/<TASK_ID>-YYYYMMDD.md`
-- Docker compose / image / Jenkins Job 变更（若有）：
-
-## 8. 风险与回滚
+## 4. 风险与回滚
 - 风险：
-- 回滚点（备份/回滚步骤）：
+- 回滚方式：
 
-## 9. 后续行动（如有）
+## 5. 后续行动
 - TODO：

package/cli/assets/skill/data/templates/docs/tasks/taskbook.md

@@ -1,34 +1,41 @@
-# Taskbook（任务本：持续续写，权威任务来源）
+# Taskbook（任务本：持续续写，默认权威任务来源）
 
 规则：
-1) 所有任务都写在本文件（持续续写，不另起任务文件）
-2) 允许拆子任务：每个子任务也必须走全流程（DD→实现→测试→review→接口文档→本地 Compose 验证→回归→总结→commit→push→Jenkins 验证）
-3) 每个任务必须有明确验收与证据（日志/报告/文件路径）
+1) 所有任务都写在本文件（持续续写，不另起零散任务文件）
+2) 普通小改动只要求最小设计记录；跨模块、接口、数据库、部署、Jenkins、关键页面流程变更才补 DD
+3) 每个任务最终必须有闭环证据：提交、Jenkins、目标环境验证、结果、遗留问题
+4) 长 summary 不是默认强制产物；只有高风险或需要完整复盘时再补
 
 ---
 
 ## Task T0001 — <Title>
-- 状态：Planned | Designing | Implementing | Testing | Reviewing | Runtime Verifying | Pipeline Verifying | Done
+- 状态：Planned | Designing | Implementing | Local Checking | Pipeline Verifying | Target Verifying | Done | Blocked
 - 范围（In scope）：
 - 非目标（Out of scope）：
-- 验收标准（必须可执行）：
-- 依赖/约束：
-- 子任务：
+- 是否高风险（Yes/No）：
+- 高风险分类（如有）：DB / Auth / Payment / Jenkins / Gateway / Upload / Prod Config
+- 影响面（API / DB / Jenkins / Page / Config / Deploy）：
+- 最小设计记录：
+- 验收标准：
+- 子任务（如有）：
   - [ ] T0001-1 <subtask>
-  - [ ] T0001-2 <subtask>
 
-### 证据（完成后填写）
-- 项目配置：`docs/ENGINEERING.md`（frontmatter）
+### 默认证据（完成后填写）
+- 项目配置：`docs/ENGINEERING.md`
+- 提交：<commit sha>
+- Jenkins Build：<build url>
+- 目标环境验证：<health/api/page/business path>
+- 闭环记录：`docs/tasks/closure-log.md`
+
+### 按需补充证据（仅在需要时填写）
 - DD：`docs/design/T0001-<slug>.md`
 - Review：`docs/reviews/T0001-YYYYMMDD-HHMM.md`
 - API 文档：`docs/interfaces/api.md`
 - API Change Log：`docs/interfaces/api-change-log.md`
-- 本地CI：粘贴摘要或给出文件路径
-- 本地 Compose 验证：命令输出或 Review 文档摘要
-- Jenkins 部署记录：`docs/deployment/deploy-records/T0001-YYYYMMDD.md`
-- 回归矩阵：`docs/testing/regression-matrix.md`（全量PASS，且每项必须有真实证据）
-- Bug清单（如有）：`docs/bugs/bug-list.md`
-- 任务总结（强制）：`docs/tasks/summaries/T0001.md`
+- 回归矩阵：`docs/testing/regression-matrix.md`
+- Bug 清单：`docs/bugs/bug-list.md`
+- Task Summary：`docs/tasks/summaries/T0001.md`
+- Deployment Record：`docs/deployment/deploy-records/T0001-YYYYMMDD.md`
 
 ---
 

package/cli/assets/skill/data/templates/docs/testing/regression-matrix.md

@@ -1,11 +1,11 @@
-# Regression Matrix（本地 Compose 环境回归矩阵：必须全量 PASS，0 fail）
+# Regression Matrix（按需回归记录，不是每个小改动的默认门禁）
 
-> 1. 仅记录当前真实实现，不要预填伪接口或目标态接口。
+> 1. 只记录真实执行过的回归项。
 > 2. `Status` 允许值：`TODO` / `PASS` / `FAIL`。
-> 3. 新增或未执行项默认填写 `TODO`，不得预填 `PASS`。
-> 4. `PASS` 只允许在真实执行后填写，且 `Evidence` 不得保留占位符。
-> 5. `python3 docs/tools/autopipeline/ap.py check-matrix` 会把非 `PASS` 行和占位符证据视为未完成。
+> 3. 未执行项保持 `TODO`，不得预填 `PASS`。
+> 4. 只有真实执行并具备证据时，才允许填写 `PASS`。
+> 5. `check-matrix` 只在显式要求完整回归时使用，不作为默认小改动门禁。
 
 | ID | Area | Endpoint/Feature | Test Type | Steps / Command | Expected | Status(TODO/PASS/FAIL) | Evidence |
 |---|---|---|---|---|---|---|---|
-| R-001 | API | <Endpoint or feature> | <smoke/regression/manual> | <command or manual steps> | <expected result> | TODO | <fill-with-log-path-screenshot-or-report> |
+| R-001 | <Area> | <Endpoint or feature> | <manual/smoke/regression> | <command or manual steps> | <expected result> | TODO | <real log path / screenshot / report> |