@elvis1513/auto-coding-skill 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# auto-coding-skill
+
+Portable, framework-agnostic engineering workflow skill for:
+
+- Claude Code
+- Codex CLI
+
+It enforces an end-to-end gate:
+
+Task -> DD -> Implement -> Build/Test -> Static Analysis -> Review -> API Docs (Markdown) -> Deploy -> Smoke -> Full Regression -> Bug Log -> Summary -> Commit -> Push
+
+## Install (npm)
+
+```bash
+npm install -g @elvis1513/auto-coding-skill
+```
+
+If npm registry install is not available yet, install directly from GitHub:
+
+```bash
+npm install -g git+https://github.com/elvis1513/auto-coding-skill.git
+```
+
+## Quick start (any repo)
+
+From your target repo root:
+
+```bash
+# install skill files for Claude
+autocoding init --ai claude
+
+# install skill files for Codex
+autocoding init --ai codex
+
+# install both
+autocoding init --ai all
+```
+
+Skill install locations:
+
+- `.claude/skills/auto-coding-skill`
+- `.codex/skills/auto-coding-skill`
+
+Then initialize the project scaffold (run one path that exists):
+
+```bash
+python3 .claude/skills/auto-coding-skill/scripts/ap.py --repo . install
+# or
+python3 .codex/skills/auto-coding-skill/scripts/ap.py --repo . install
+```
+
+This creates:
+
+- `ENGINEERING.md`
+- `docs/**` (taskbook, DD/review templates, API docs, deployment/runbook, regression matrix, bug list)
+- `tools/autopipeline/ap.py` + `tools/autopipeline/core.py`
+- `.gitignore` rule: `docs/deployment/targets.yaml`
+
+## Configure project commands
+
+```bash
+cp docs/autocoding/config.example.yaml autocoding.config.yaml
+```
+
+Edit at least:
+
+- `commands.build`
+- `commands.test`
+- `commands.lint`
+- `commands.typecheck`
+- `commands.smoke`
+- `commands.regression`
+
+## Gate commands
+
+```bash
+python3 tools/autopipeline/ap.py run build
+python3 tools/autopipeline/ap.py run test
+python3 tools/autopipeline/ap.py verify-api-docs
+python3 tools/autopipeline/ap.py check-matrix
+python3 tools/autopipeline/ap.py gen-summary T0001-1
+python3 tools/autopipeline/ap.py commit-push T0001-1 --msg "T0001-1: <summary>" --require-matrix
+```
+
+## CLI options
+
+```bash
+autocoding init --ai claude|codex|all [--mode project|global] [--dest <path>] [--force]
+```
+
+When `--ai all` and `--dest` are both used, output will be:
+
+- `<dest>/claude`
+- `<dest>/codex`
+
+## Publish
+
+```bash
+npm login
+npm whoami
+npm run release:check
+npm publish --access public
+```
+
+Optional automation: this repo includes `/Users/elvis/Product/auto-coding-skill/.github/workflows/npm-publish.yml`.  
+Set GitHub secret `NPM_TOKEN`, then publish a GitHub Release to auto-publish npm.
+
+## License
+
+MIT

package/cli/assets/skill/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: auto-coding-skill
+description: Framework-agnostic engineering workflow skill for Claude Code and Codex CLI. Use it to scaffold docs and enforce gates from task intake to design, implementation, test, review, API docs, deployment, regression, summary, commit and push.
+---
+
+# Auto Coding Skill (Claude + Codex Only)
+
+This skill is portable across projects and does not depend on any specific scaffold.
+
+## Supported clients
+
+- Claude Code
+- Codex CLI
+
+## Workflow gates
+
+Taskbook -> DD -> Implement -> Build/Test -> Static Analysis -> Review -> API Docs -> Deploy -> Smoke -> Regression Matrix (0 fail) -> Summary -> Commit -> Push
+
+## Install into a target repo
+
+From the target repo root:
+
+```bash
+# Claude Code
+autocoding init --ai claude
+
+# Codex CLI
+autocoding init --ai codex
+
+# Both
+autocoding init --ai all
+```
+
+## Initialize project scaffold
+
+Run one of the following (depending on where the skill was installed):
+
+```bash
+python3 .claude/skills/auto-coding-skill/scripts/ap.py --repo . install
+# or
+python3 .codex/skills/auto-coding-skill/scripts/ap.py --repo . install
+```
+
+This will create `ENGINEERING.md`, `docs/**`, `tools/autopipeline/ap.py`, and update `.gitignore` with `docs/deployment/targets.yaml`.
+
+## Configure project commands
+
+Copy and edit config:
+
+```bash
+cp docs/autocoding/config.example.yaml autocoding.config.yaml
+```
+
+Set at least:
+
+- `commands.build`
+- `commands.test`
+- `commands.lint`
+- `commands.typecheck`
+- `commands.smoke`
+- `commands.regression`
+
+## Common commands
+
+```bash
+python3 tools/autopipeline/ap.py run build
+python3 tools/autopipeline/ap.py run test
+python3 tools/autopipeline/ap.py run lint
+python3 tools/autopipeline/ap.py verify-api-docs
+python3 tools/autopipeline/ap.py check-matrix
+python3 tools/autopipeline/ap.py gen-summary T0001-1
+python3 tools/autopipeline/ap.py commit-push T0001-1 --msg "T0001-1: <summary>" --require-matrix
+```

package/cli/assets/skill/data/templates/ENGINEERING.md

@@ -0,0 +1,63 @@
+# ENGINEERING.md — AutoPipeline Gates (Source of Truth)
+
+目标：把一次任务固化为不可跳过的流水线：  
+读任务 → 写DD → 实现 → 本地测试通过 → 静态分析+Review落盘 → 更新API Markdown+接口变更清单 →  
+部署(systemd/jar) → 重启验证 → 按API Markdown全量回归 + 回归矩阵0fail →  
+记录Bug并新增自动化回归 → 任务总结落盘 → commit → push
+
+规则：任一步骤失败或缺产物，禁止进入下一步；**未 push 视为任务未完成**，禁止开始下一个任务/子任务。
+
+---
+
+## 0. 权威输入与冲突裁决（优先级）
+## 0.1 工程命令配置（必须）
+
+- 构建/测试/静态分析/回归命令必须由项目提供并配置在：
+  - `autocoding.config.yaml`（推荐放 repo 根目录），或
+  - `docs/autocoding/config.yaml`
+
+任何 gate 只允许通过这些配置的命令执行（避免把流程绑死在某个脚手架）。
+
+
+1) ENGINEERING.md（本文件）  
+2) docs/tasks/taskbook.md  
+3) docs/design/**  
+4) docs/interfaces/api.md  
+5) docs/interfaces/api-change-log.md  
+6) docs/requirements/regression-matrix.md（必须 0 FAIL）  
+7) docs/bugs/bug-list.md（长期积累，回归必测）  
+8) docs/tasks/summaries/**（每任务一份，强制产物）  
+9) docs/deployment/**  
+10) 代码实现（不得反向覆盖 1~9）
+
+---
+
+## 1. Gate 流水线（强制、不可跳过）
+
+Gate-1 读任务：只从 taskbook 取范围与验收；缺信息先补 taskbook  
+Gate-2 写DD：无DD禁止写代码；DD必须含 时序图/ER图/接口时序（Mermaid）  
+Gate-3 实现：严格按DD；接口变更必须同步 API Markdown  
+Gate-4 本地CI：必须通过（ci-local）  
+Gate-5 静态分析+Review：静态分析通过；docs/reviews/ 生成记录  
+Gate-6 文档：更新 api.md + 追加 api-change-log.md  
+Gate-7 部署：单机 systemd/jar；允许 root+密码；service目录固定 /usr/lib/systemd/system；只保留1份备份；失败自动回滚  
+Gate-8 重启+健康：restart后必须健康检查通过  
+Gate-9 全量回归：按 API Markdown 全量回归；回归矩阵全量 PASS（0 fail）；发现问题必须写 bug-list 并新增自动化回归用例（纳入 Gate-9）  
+Gate-10 任务总结：必须生成 docs/tasks/summaries/<TASK_ID>.md（可用工具生成初稿）  
+Gate-11 完成：全门禁通过后必须 commit+push（未push=未完成）
+
+---
+
+## 2. 部署约束（来自你的固定要求）
+
+- 允许 sshpass / 或 python 读取 targets.yaml 的 root 密码（非交互）
+- systemd 目录固定：/usr/lib/systemd/system
+- 只保留一个最新备份（*.bak / *.tgz.bak），失败自动回滚并重启服务
+- 健康检查端点不固定：targets.yaml 配置 base_url + health_path
+- 部署可更新项：app/config/、app/bin/、/usr/lib/systemd/system/*.service、jar
+
+---
+
+## 3. Repo 工具入口（建议）
+
+统一用 `python3 tools/autopipeline/ap.py <command>` 执行。

package/cli/assets/skill/data/templates/bridges/CLAUDE.md

@@ -0,0 +1 @@
+Follow ENGINEERING.md strictly. Source of truth: ENGINEERING.md.

package/cli/assets/skill/data/templates/bridges/CODEX.md

@@ -0,0 +1 @@
+Follow ENGINEERING.md strictly. Source of truth: ENGINEERING.md.

package/cli/assets/skill/data/templates/docs/adr/0001-adr-template.md

@@ -0,0 +1,9 @@
+# ADR NNNN — <Title>
+- 状态：Proposed | Accepted | Rejected | Deprecated
+- 日期：YYYY-MM-DD
+## Context
+## Decision
+## Alternatives
+## Consequences
+## Rollback
+## Follow-ups

package/cli/assets/skill/data/templates/docs/autocoding/config.example.yaml

@@ -0,0 +1,35 @@
+# Project-specific gate commands.
+# This file is intentionally NOT a “universal standard” — you MUST adapt commands to each repo.
+# You can copy this to repo root as `autocoding.config.yaml` (recommended).
+
+commands:
+  # Build / packaging must succeed (no errors)
+  build: "npm run build"
+
+  # Tests must be 0 fail
+  test: "npm test"
+
+  # TS/JS static analysis (recommend both)
+  lint: "npm run lint"
+  typecheck: "npm run typecheck"
+
+  # Optional
+  format: "npm run format"
+
+  # Post-deploy smoke check (can call curl or a node script)
+  smoke: "node ./scripts/smoke.mjs"
+
+  # Full regression (can be API regression, e2e, integration, etc.)
+  regression: "npm run test:regression"
+
+docs:
+  # authoritative API doc (Markdown)
+  api_doc: "docs/interfaces/api.md"
+  api_change_log: "docs/interfaces/api-change-log.md"
+  taskbook: "docs/tasks/taskbook.md"
+  regression_matrix: "docs/requirements/regression-matrix.md"
+  bug_list: "docs/bugs/bug-list.md"
+
+deployment:
+  targets_file: "docs/deployment/targets.yaml"
+  systemd_dir: "/usr/lib/systemd/system"

package/cli/assets/skill/data/templates/docs/bugs/bug-list.md

@@ -0,0 +1,5 @@
+# Bug List（长期积累：回归必测）
+
+| Bug ID | Date | Area | Summary | Steps to Reproduce | Expected | Actual | Severity | Status | Fix Commit/PR | Regression Test ID |
+|---|---|---|---|---|---|---|---|---|---|---|
+| B-0001 | YYYY-MM-DD | API | <desc> | <steps> | <expected> | <actual> | P1 | Open |  | R-??? |

package/cli/assets/skill/data/templates/docs/deployment/deploy-records/_TEMPLATE-DEPLOY-RECORD.md

@@ -0,0 +1,13 @@
+# Deploy Record — <Task ID> — YYYY-MM-DD
+
+- Target host:
+- Service name:
+- Artifact (local):
+- Remote jar path:
+- Updated items: jar / config / bin / service
+- Backup files (single latest): *.bak / *.tgz.bak
+
+## Evidence
+- systemctl status:
+- smoke_test:
+- api_regression:

package/cli/assets/skill/data/templates/docs/deployment/deploy-runbook.md

@@ -0,0 +1,13 @@
+# Deploy Runbook（单机 systemd / jar）
+
+targets.yaml 必填：
+- target.host/user/password/ssh_port
+- service.name（systemd service 文件名）
+- service.systemd_dir（固定：/usr/lib/systemd/system）
+- paths.remote_*（远端目录与 jar 路径）
+- health.base_url + health_path（可配置）
+
+部署后必须：
+- smoke-test
+- api-regression
+- 回归矩阵全量 PASS（0 fail）

package/cli/assets/skill/data/templates/docs/deployment/targets.example.yaml

@@ -0,0 +1,23 @@
+target:
+  host: "192.168.1.10"
+  user: "root"
+  password: "CHANGE_ME"
+  ssh_port: 22
+
+service:
+  name: "myapp.service"
+  systemd_dir: "/usr/lib/systemd/system"
+  local_file: "app/systemd/myapp.service"
+
+paths:
+  remote_app_root: "/opt/app/myapp"
+  remote_jar_path: "/opt/app/myapp/app.jar"
+  remote_config_dir: "/opt/app/myapp/config"
+  remote_bin_dir: "/opt/app/myapp/bin"
+
+artifact:
+  local_path: ""
+
+health:
+  base_url: "http://127.0.0.1:8080"
+  health_path: "/health"

package/cli/assets/skill/data/templates/docs/design/_TEMPLATE-DD.md

@@ -0,0 +1,43 @@
+# DD — <Task ID> <Title>
+
+- Task ID：T0001 / T0001-1
+- 状态：Draft | Reviewed | Approved
+- 关联：`docs/tasks/taskbook.md` 中对应段落
+
+## 1. 背景与目标
+## 2. 范围与非目标
+## 3. 现状与问题
+## 4. 方案与取舍
+## 5. 接口设计（与 docs/interfaces/api.md 对齐）
+## 6. 数据设计（迁移/回滚）
+
+## 7. 时序图（强制）
+```mermaid
+sequenceDiagram
+  participant C as Client
+  participant A as API
+  participant S as Service
+  participant D as DB
+  C->>A: request
+  A->>S: call
+  S->>D: query/tx
+  D-->>S: result
+  S-->>A: response
+  A-->>C: response
+```
+
+## 8. ER 图（强制）
+```mermaid
+erDiagram
+  ENTITY_A ||--o{ ENTITY_B : relates
+  ENTITY_A { string id }
+  ENTITY_B { string id string a_id }
+```
+
+## 9. 接口时序/调用编排（强制）
+## 10. 测试方案（必须自动化 + 覆盖历史 bug）
+## 11. 安全与合规
+## 12. 性能与容量
+## 13. 风险清单
+## 14. 回滚方案
+## 15. 影响面与发布计划

package/cli/assets/skill/data/templates/docs/interfaces/api-change-log.md

@@ -0,0 +1,11 @@
+# API Change Log（接口变更清单：追加式）
+
+---
+
+## T0001 — <Title> — YYYY-MM-DD
+- 新增：
+- 修改：
+- 废弃：
+- 兼容策略：
+- 迁移/升级说明：
+- 影响面：

package/cli/assets/skill/data/templates/docs/interfaces/api.md

@@ -0,0 +1,36 @@
+# API Documentation（权威接口文档）
+
+> 本文件为权威接口文档。任何接口新增/修改/废弃，都必须同步更新本文件，并在 `api-change-log.md` 追加记录。
+
+## 1. 基本约定
+- Base URL：
+- Content-Type：
+- 认证方式（如有）：
+- 时区/时间格式：
+- 分页/排序（如有）：
+- 错误码规范：
+
+## 2. Endpoint Index（目录）
+| Method | Path | Summary | Auth | Request | Response |
+|---|---|---|---|---|---|
+| GET | /health | Health check | No | - | 200 OK |
+
+## 3. Endpoints
+
+### 3.1 GET /health
+**Summary**: Health check
+
+**Request**
+- Headers: -
+- Query: -
+- Body: -
+
+**Response**
+- 200: OK
+  - Example:
+    ```json
+    {"status":"ok"}
+    ```
+
+## 4. Changelog
+- See `api-change-log.md`

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

@@ -0,0 +1,5 @@
+# Regression Matrix（回归矩阵：必须全量 PASS，0 fail）
+
+| ID | Area | Endpoint/Feature | Test Type | Steps / Command | Expected | Status(PASS/FAIL) | Evidence |
+|---|---|---|---|---|---|---|---|
+| R-001 | API | GET /health | smoke | commands.smoke | 200 OK | PASS | <paste log path> |

package/cli/assets/skill/data/templates/docs/reviews/_TEMPLATE-REVIEW.md

@@ -0,0 +1,14 @@
+# Review — <Task ID> — YYYY-MM-DD HH:MM
+
+## 1. 静态分析结果（必须）
+- Command：lint + typecheck（来自 autocoding.config.yaml）
+- Summary：
+- Issues：
+- Resolved/Deferred（deferred 必须 ADR）：
+
+## 2. 代码质量
+## 3. 测试质量（含新增回归用例）
+## 4. 接口契约（API Markdown + change-log）
+## 5. 安全与性能
+## 6. 风险与回滚
+## 7. 结论（Pass / Blocked）

package/cli/assets/skill/data/templates/docs/specs/security-baseline.md

@@ -0,0 +1,5 @@
+# Security Baseline（最低门槛）
+
+- secrets 不入库：targets.yaml（本地）或环境变量
+- 写接口必须：输入校验、审计日志、反滥用
+- 依赖审计：高危依赖必须处理或 ADR 解释

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

@@ -0,0 +1,50 @@
+# Task Summary — <TASK_ID> — <Title>
+
+- Task ID：<TASK_ID>
+- Date：YYYY-MM-DD
+- Scope（本次范围）：
+- Out of scope（明确未做）：
+
+---
+
+## 1. 目标与验收结论
+- 目标：
+- 验收结论：PASS / FAIL（FAIL 必须说明原因与后续计划）
+
+## 2. 变更概览（代码/配置/部署）
+- 关键改动点：
+- 影响模块：
+- 兼容性影响（是否破坏兼容、迁移方案）：
+
+## 3. 接口变更（以 API Markdown 为准）
+- 新增：
+- 修改：
+- 废弃：
+- 变更记录位置：`docs/interfaces/api-change-log.md`（对应条目）
+
+## 4. 数据变更（如有）
+- 表/字段变更：
+- 迁移方式：
+- 回滚方式：
+
+## 5. 质量门禁证据（必须可追溯）
+- 本地CI：`ci-local`
+- 静态分析：`static`
+- Review 文档：`docs/reviews/<TASK_ID>-<timestamp>.md`
+- API 文档：`docs/interfaces/api.md`
+- 回归矩阵：`docs/requirements/regression-matrix.md`（全量 PASS，0 fail）
+
+## 6. Bug 清单与回归用例
+- 新增/确认的 Bug（写入 `docs/bugs/bug-list.md`）：
+- 新增自动化回归用例（引用回归矩阵ID）：
+
+## 7. 部署记录（如有部署）
+- 部署记录：`docs/deployment/deploy-records/<TASK_ID>-YYYYMMDD.md`
+- systemd/service/config/bin 变更（若有）：
+
+## 8. 风险与回滚
+- 风险：
+- 回滚点（备份/回滚步骤）：
+
+## 9. 后续行动（如有）
+- TODO：

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

@@ -0,0 +1,33 @@
+# Taskbook（任务本：持续续写，权威任务来源）
+
+规则：
+1) 所有任务都写在本文件（持续续写，不另起任务文件）
+2) 允许拆子任务：每个子任务也必须走全流程（DD→实现→测试→review→接口文档→部署→回归→总结→commit→push）
+3) 每个任务必须有明确验收与证据（日志/报告/文件路径）
+
+---
+
+## Task T0001 — <Title>
+- 状态：Planned | Designing | Implementing | Testing | Reviewing | Deploying | Done
+- 范围（In scope）：
+- 非目标（Out of scope）：
+- 验收标准（必须可执行）：
+- 依赖/约束：
+- 子任务：
+  - [ ] T0001-1 <subtask>
+  - [ ] T0001-2 <subtask>
+
+### 证据（完成后填写）
+- 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：粘贴摘要或给出文件路径
+- 部署记录（如部署）：`docs/deployment/deploy-records/T0001-YYYYMMDD.md`
+- 回归矩阵：`docs/requirements/regression-matrix.md`（全量PASS）
+- Bug清单（如有）：`docs/bugs/bug-list.md`
+- 任务总结（强制）：`docs/tasks/summaries/T0001.md`
+
+---
+
+继续在下方追加任务（不要删除历史记录）

package/cli/assets/skill/requirements.txt

@@ -0,0 +1,2 @@
+pyyaml>=6.0
+requests>=2.31.0

package/cli/assets/skill/scripts/ap.py

@@ -0,0 +1,254 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""AutoPipeline Pro Max - repo automation CLI (python)"""
+
+from __future__ import annotations
+
+import argparse
+import datetime as _dt
+from pathlib import Path
+from typing import Optional, List
+
+from core import APError, ensure_git_repo, copy_tree, run, load_yaml, find_config, run_shell
+
+
+def _skill_root() -> Path:
+    return Path(__file__).resolve().parent.parent
+
+
+def cmd_install(args: argparse.Namespace) -> None:
+    repo = Path(args.repo).resolve()
+    templates = _skill_root() / "data" / "templates"
+
+    copy_tree(templates / "docs", repo / "docs")
+    copy_tree(templates / "ENGINEERING.md", repo / "ENGINEERING.md")
+
+    if args.bridges:
+        copy_tree(templates / "bridges", repo)
+
+    tools_dir = repo / "tools" / "autopipeline"
+    tools_dir.mkdir(parents=True, exist_ok=True)
+    copy_tree(Path(__file__).resolve(), tools_dir / "ap.py")
+    copy_tree(Path(__file__).resolve().parent / "core.py", tools_dir / "core.py")
+
+    gi = repo / ".gitignore"
+    secret_line = "docs/deployment/targets.yaml"
+    if gi.exists():
+        txt = gi.read_text(encoding="utf-8")
+        if secret_line not in txt:
+            gi.write_text(txt.rstrip() + "\n" + secret_line + "\n", encoding="utf-8")
+    else:
+        gi.write_text(secret_line + "\n", encoding="utf-8")
+
+    print(f"[install] OK: scaffold installed into {repo}")
+    print("[install] Next: cp docs/deployment/targets.example.yaml docs/deployment/targets.yaml (fill secrets locally)")
+
+
+def _infer_title(repo: Path, task_id: str) -> str:
+    taskbook = repo / "docs" / "tasks" / "taskbook.md"
+    if not taskbook.exists():
+        return "<Title>"
+    for line in taskbook.read_text(encoding="utf-8").splitlines():
+        if line.strip().startswith("## Task ") and task_id in line:
+            for sep in ["—", "-"]:
+                if sep in line:
+                    return line.split(sep, 1)[1].strip()
+    return "<Title>"
+
+
+def cmd_gen_summary(args: argparse.Namespace) -> None:
+    repo = Path(args.repo).resolve()
+    ensure_git_repo(repo)
+    task_id = args.task_id
+
+    out_dir = repo / "docs" / "tasks" / "summaries"
+    out_dir.mkdir(parents=True, exist_ok=True)
+    out_file = out_dir / f"{task_id}.md"
+    if out_file.exists() and not args.force:
+        raise APError(f"Summary already exists: {out_file} (use --force to overwrite)")
+
+    title = _infer_title(repo, task_id)
+    date = _dt.date.today().isoformat()
+
+    staged = run(["git", "diff", "--cached", "--name-only"], cwd=repo, check=False).stdout.strip()
+    unstaged = run(["git", "diff", "--name-only"], cwd=repo, check=False).stdout.strip()
+    status = run(["git", "status", "--porcelain=v1"], cwd=repo, check=False).stdout.strip()
+
+    content = f"""# Task Summary — {task_id} — {title}
+
+- Task ID：{task_id}
+- Date：{date}
+- Scope（本次范围）：TODO
+- Out of scope（明确未做）：TODO
+
+---
+
+## 1. 目标与验收结论
+- 目标：TODO
+- 验收结论：PASS / FAIL — TODO
+
+## 2. 变更概览（代码/配置/部署）
+### Git change snapshot
+- Staged files:
+{('- ' + staged.replace('\n','\n- ')) if staged else '- (none)'}
+- Unstaged files:
+{('- ' + unstaged.replace('\n','\n- ')) if unstaged else '- (none)'}
+- Status:
+```text
+{status}
+```
+
+## 3. 接口变更（以 API Markdown 为准）
+- 变更记录位置：`docs/interfaces/api-change-log.md`
+
+## 5. 质量门禁证据（必须可追溯）
+- 本地CI：TODO
+- 静态分析：TODO
+- Review 文档：TODO
+- DD 文档：TODO
+- 回归矩阵：`docs/requirements/regression-matrix.md`（全量 PASS，0 fail）
+"""
+
+    out_file.write_text(content, encoding="utf-8")
+    print(f"[gen-summary] OK: {out_file}")
+
+
+def cmd_check_matrix(args: argparse.Namespace) -> None:
+    repo = Path(args.repo).resolve()
+    matrix = repo / "docs" / "requirements" / "regression-matrix.md"
+    if not matrix.exists():
+        raise APError(f"Matrix not found: {matrix}")
+
+    rows = 0
+    fail = []
+    for line in matrix.read_text(encoding="utf-8").splitlines():
+        s = line.strip()
+        if not s.startswith("|"):
+            continue
+        cols = [c.strip() for c in s.split("|")[1:-1]]
+        if len(cols) < 8:
+            continue
+        rid = cols[0]
+        status = cols[6].upper()
+        if rid in {"ID", "---"} or rid.startswith("---"):
+            continue
+        if not rid.startswith("R-"):
+            continue
+        rows += 1
+        if status != "PASS":
+            fail.append((rid, status or "(empty)"))
+
+    if rows == 0:
+        raise APError(f"No regression rows found in matrix: {matrix}")
+
+    if fail:
+        msg = "\n".join([f"- {rid}: {st}" for rid, st in fail])
+        raise APError(f"Regression matrix not 0-fail:\n{msg}")
+
+    print("[check-matrix] OK (0-fail)")
+
+
+def _load_cfg(repo: Path) -> dict:
+    cfg_path = find_config(repo)
+    return load_yaml(cfg_path)
+
+
+def cmd_run(args: argparse.Namespace) -> None:
+    """
+    Run a configured gate command:
+      build | test | lint | typecheck | format | smoke | regression
+    Commands are read from autocoding.config.yaml (or docs/autocoding/config.yaml).
+    """
+    repo = Path(args.repo).resolve()
+    cfg = _load_cfg(repo)
+    commands = (cfg.get("commands") or {})
+    name = args.name
+    if name not in commands:
+        raise APError(f"Command not configured: commands.{name}. Edit autocoding.config.yaml. Available: {', '.join(commands.keys()) or '(none)'}")
+    cmd = str(commands[name])
+    print(f"[run] {name}: {cmd}")
+    run_shell(cmd, cwd=repo)
+    print(f"[run] OK: {name}")
+
+
+def cmd_verify_api_docs(args: argparse.Namespace) -> None:
+    """Ensure API markdown doc and change-log exist."""
+    repo = Path(args.repo).resolve()
+    cfg = _load_cfg(repo)
+    docs = (cfg.get("docs") or {})
+    api_doc = Path(repo, str(docs.get("api_doc", "docs/interfaces/api.md")))
+    change_log = Path(repo, str(docs.get("api_change_log", "docs/interfaces/api-change-log.md")))
+    missing = [p for p in [api_doc, change_log] if not p.exists()]
+    if missing:
+        raise APError("Missing API docs: " + ", ".join([str(p) for p in missing]))
+    print(f"[verify-api-docs] OK: {api_doc} + {change_log}")
+
+
+def cmd_commit_push(args: argparse.Namespace) -> None:
+    repo = Path(args.repo).resolve()
+    ensure_git_repo(repo)
+
+    task_id = args.task_id
+    msg = args.msg
+
+    summary = repo / "docs" / "tasks" / "summaries" / f"{task_id}.md"
+    if not summary.exists():
+        raise APError(
+            f"Task summary missing: {summary}\n"
+            f"Generate: python3 tools/autopipeline/ap.py gen-summary {task_id}"
+        )
+
+    if args.require_matrix:
+        cmd_check_matrix(argparse.Namespace(repo=str(repo)))
+
+    run(["git", "add", "-A"], cwd=repo)
+    diff = run(["git", "diff", "--cached", "--name-only"], cwd=repo).stdout.strip()
+    if not diff:
+        raise APError("Nothing to commit.")
+
+    run(["git", "commit", "-m", msg], cwd=repo)
+    run(["git", "push"], cwd=repo)
+    print("[commit-push] OK")
+
+
+def main(argv: Optional[List[str]] = None) -> int:
+    p = argparse.ArgumentParser(prog="autopipeline")
+    p.add_argument("--repo", default=".")
+    sp = p.add_subparsers(dest="cmd", required=True)
+
+    s = sp.add_parser("install")
+    s.add_argument("--bridges", action="store_true")
+    s.set_defaults(func=cmd_install)
+
+    s = sp.add_parser("gen-summary")
+    s.add_argument("task_id")
+    s.add_argument("--force", action="store_true")
+    s.set_defaults(func=cmd_gen_summary)
+
+    s = sp.add_parser("check-matrix")
+    s.set_defaults(func=cmd_check_matrix)
+
+    s = sp.add_parser("run")
+    s.add_argument("name")
+    s.set_defaults(func=cmd_run)
+
+    s = sp.add_parser("verify-api-docs")
+    s.set_defaults(func=cmd_verify_api_docs)
+
+    s = sp.add_parser("commit-push")
+    s.add_argument("task_id")
+    s.add_argument("--msg", required=True)
+    s.add_argument("--require-matrix", action="store_true")
+    s.set_defaults(func=cmd_commit_push)
+
+    try:
+        args = p.parse_args(argv)
+        args.func(args)
+        return 0
+    except APError as e:
+        print(f"[ERROR] {e}")
+        return 2
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/cli/assets/skill/scripts/core.py

@@ -0,0 +1,107 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""AutoPipeline Pro Max - Core helpers"""
+
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+from pathlib import Path
+from typing import Iterable, Optional, Dict, Any
+
+try:
+    import yaml  # type: ignore
+except Exception:
+    yaml = None
+
+try:
+    import requests  # type: ignore
+except Exception:
+    requests = None
+
+
+class APError(RuntimeError):
+    pass
+
+
+def run(cmd: Iterable[str], cwd: Optional[Path] = None, check: bool = True) -> subprocess.CompletedProcess:
+    p = subprocess.run(list(cmd), cwd=str(cwd) if cwd else None, text=True, capture_output=True)
+    if check and p.returncode != 0:
+        raise APError(
+            f"Command failed ({p.returncode}): {' '.join(cmd)}\nSTDOUT:\n{p.stdout}\nSTDERR:\n{p.stderr}"
+        )
+    return p
+
+
+def ensure_git_repo(repo: Path) -> None:
+    try:
+        run(["git", "rev-parse", "--is-inside-work-tree"], cwd=repo)
+    except APError as e:
+        raise APError(f"Not a git repository: {repo}\n{e}") from e
+
+
+def load_yaml(path: Path) -> Dict[str, Any]:
+    if not path.exists():
+        raise APError(f"YAML not found: {path}")
+    if yaml is None:
+        raise APError(
+            "PyYAML not installed. Install dependencies with: pip install pyyaml requests"
+        )
+    with path.open("r", encoding="utf-8") as f:
+        data = yaml.safe_load(f)
+    return data or {}
+
+
+def copy_tree(src: Path, dst: Path) -> None:
+    if src.is_file():
+        if src.name == ".DS_Store" or src.name.endswith(".pyc"):
+            return
+        dst.parent.mkdir(parents=True, exist_ok=True)
+        shutil.copy2(src, dst)
+        return
+    for root, _, files in os.walk(src):
+        root_p = Path(root)
+        if "__pycache__" in root_p.parts:
+            continue
+        rel = root_p.relative_to(src)
+        for fn in files:
+            if fn == ".DS_Store" or fn.endswith(".pyc"):
+                continue
+            s = root_p / fn
+            d = dst / rel / fn
+            d.parent.mkdir(parents=True, exist_ok=True)
+            shutil.copy2(s, d)
+
+
+def http_get_status(url: str, timeout_s: int = 5) -> int:
+    if requests is None:
+        raise APError(
+            "requests not installed. Install dependencies with: pip install pyyaml requests"
+        )
+    r = requests.get(url, timeout=timeout_s)
+    return r.status_code
+
+
+def find_config(repo: Path) -> Path:
+    """Find autocoding config file (repo root preferred)."""
+    candidates = [
+        repo / "autocoding.config.yaml",
+        repo / "docs" / "autocoding" / "config.yaml",
+        repo / "docs" / "autocoding" / "config.yml",
+    ]
+    for c in candidates:
+        if c.exists():
+            return c
+    # fall back to example if exists (for first-time users)
+    ex = repo / "docs" / "autocoding" / "config.example.yaml"
+    if ex.exists():
+        return ex
+    raise APError("autocoding config not found. Create autocoding.config.yaml (recommended) or docs/autocoding/config.yaml. Template: docs/autocoding/config.example.yaml")
+
+
+def run_shell(command: str, cwd: Optional[Path] = None) -> None:
+    """Run shell command via bash -lc for cross-tool compatibility."""
+    p = subprocess.run(["bash", "-lc", command], cwd=str(cwd) if cwd else None, text=True)
+    if p.returncode != 0:
+        raise APError(f"Command failed ({p.returncode}): {command}")

package/cli/src/index.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { fileURLToPath } from "node:url";
+
+function die(msg){
+  console.error(`\n[autocoding] ERROR: ${msg}\n`);
+  process.exit(1);
+}
+
+function parseArgs(argv){
+  const args = { cmd: null, ai: null, mode: "project", dest: null, force: false };
+  const [,, cmd, ...rest] = argv;
+  args.cmd = cmd ?? "help";
+  for (let i = 0; i < rest.length; i++) {
+    const a = rest[i];
+    if (a === "--ai") args.ai = rest[++i];
+    else if (a === "--mode") args.mode = rest[++i];
+    else if (a === "--dest") args.dest = rest[++i];
+    else if (a === "--force") args.force = true;
+    else if (a === "-h" || a === "--help") args.cmd = "help";
+  }
+  return args;
+}
+
+function exists(p){ try { fs.accessSync(p); return true; } catch { return false; } }
+function rmrf(p){ fs.rmSync(p, { recursive: true, force: true }); }
+function shouldSkip(name){
+  return name === "__pycache__" || name === ".DS_Store" || name.endsWith(".pyc");
+}
+
+function copyDir(src, dst){
+  fs.mkdirSync(dst, { recursive: true });
+  for (const ent of fs.readdirSync(src, { withFileTypes: true })) {
+    if (shouldSkip(ent.name)) continue;
+    const s = path.join(src, ent.name);
+    const d = path.join(dst, ent.name);
+    if (ent.isDirectory()) copyDir(s, d);
+    else fs.copyFileSync(s, d);
+  }
+}
+
+function projectRoot(){ return process.cwd(); }
+
+function resolveTargetDir(ai, mode, destOverride){
+  if (destOverride) return destOverride;
+  if (mode !== "project" && mode !== "global") die(`--mode must be 'project' or 'global'`);
+
+  if (ai === "claude") {
+    return mode === "project"
+      ? path.join(projectRoot(), ".claude", "skills", "auto-coding-skill")
+      : path.join(os.homedir(), ".claude", "skills", "auto-coding-skill");
+  }
+
+  if (ai === "codex") {
+    return mode === "project"
+      ? path.join(projectRoot(), ".codex", "skills", "auto-coding-skill")
+      : path.join(os.homedir(), ".codex", "skills", "auto-coding-skill");
+  }
+
+  die(`unknown ai: ${ai}`);
+}
+
+function ensureGitignore(projectDir){
+  const gi = path.join(projectDir, ".gitignore");
+  const line = "docs/deployment/targets.yaml";
+  if (!exists(gi)) {
+    fs.writeFileSync(gi, `${line}\n`, "utf-8");
+    return;
+  }
+  const txt = fs.readFileSync(gi, "utf-8");
+  if (!txt.includes(line)) {
+    fs.appendFileSync(gi, (txt.endsWith("\n") ? "" : "\n") + line + "\n");
+  }
+}
+
+function main(){
+  const args = parseArgs(process.argv);
+
+  if (args.cmd === "help" || !args.cmd) {
+    console.log(`
+autocoding - install auto-coding-skill (Claude Code + Codex CLI)
+
+Usage:
+  autocoding init --ai claude|codex|all [--mode project|global] [--dest <path>] [--force]
+
+Examples:
+  autocoding init --ai claude
+  autocoding init --ai codex
+  autocoding init --ai all --mode project
+  autocoding init --ai all --dest /tmp/skills
+`);
+    process.exit(0);
+  }
+
+  if (args.cmd !== "init") die(`unknown command: ${args.cmd}`);
+
+  const ai = (args.ai ?? "").toLowerCase();
+  const targets = ai === "all" ? ["claude", "codex"] : [ai];
+  if (!(["claude", "codex", "all"].includes(ai))) die(`--ai must be claude|codex|all`);
+
+  const here = path.dirname(fileURLToPath(import.meta.url));
+  const assetSkill = path.resolve(here, "..", "assets", "skill");
+  if (!exists(assetSkill)) die(`missing assets at ${assetSkill}`);
+
+  const proj = projectRoot();
+
+  for (const t of targets) {
+    const dstOverride = args.dest
+      ? (targets.length > 1 ? path.join(args.dest, t) : args.dest)
+      : null;
+    const dst = resolveTargetDir(t, args.mode, dstOverride);
+    if (exists(dst)) {
+      if (!args.force) die(`target exists: ${dst}\nRe-run with --force to overwrite.`);
+      rmrf(dst);
+    }
+    copyDir(assetSkill, dst);
+    console.log(`[autocoding] installed skill to: ${dst}`);
+  }
+
+  if (args.mode === "project") ensureGitignore(proj);
+
+  console.log("[autocoding] done.");
+}
+
+main();

package/cli/src/sync-assets.js

@@ -0,0 +1,26 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
+const srcSkill = path.join(repoRoot, "src", "auto-coding-skill");
+const dstSkill = path.join(repoRoot, "cli", "assets", "skill");
+
+function rmrf(p){ fs.rmSync(p, { recursive:true, force:true }); }
+function shouldSkip(name){
+  return name === "__pycache__" || name === ".DS_Store" || name.endsWith(".pyc");
+}
+function copyDir(src, dst){
+  fs.mkdirSync(dst, { recursive:true });
+  for (const ent of fs.readdirSync(src, { withFileTypes:true })) {
+    if (shouldSkip(ent.name)) continue;
+    const s = path.join(src, ent.name);
+    const d = path.join(dst, ent.name);
+    if (ent.isDirectory()) copyDir(s, d);
+    else fs.copyFileSync(s, d);
+  }
+}
+
+rmrf(dstSkill);
+copyDir(srcSkill, dstSkill);
+console.log("[sync-assets] updated cli/assets/skill from src/auto-coding-skill");

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@elvis1513/auto-coding-skill",
+  "version": "0.1.0",
+  "description": "CLI installer for auto-coding-skill (Claude Code + Codex CLI).",
+  "type": "module",
+  "bin": {
+    "autocoding": "cli/src/index.js"
+  },
+  "files": [
+    "cli/src",
+    "cli/assets/skill",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node -c cli/src/index.js",
+    "sync-assets": "node cli/src/sync-assets.js",
+    "release:check": "npm run sync-assets && npm run test && npm pack --dry-run"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "claude",
+    "codex",
+    "skill",
+    "automation",
+    "engineering",
+    "workflow",
+    "ci",
+    "deployment"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elvis1513/auto-coding-skill.git"
+  },
+  "homepage": "https://github.com/elvis1513/auto-coding-skill#readme",
+  "bugs": {
+    "url": "https://github.com/elvis1513/auto-coding-skill/issues"
+  }
+}