@elvis1513/auto-coding-skill 0.1.0 → 0.1.2

package/README.md

@@ -1,109 +1,115 @@
 # auto-coding-skill
 
-Portable, framework-agnostic engineering workflow skill for:
+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)
+## Install
 
 ```bash
 npm install -g @elvis1513/auto-coding-skill
 ```
 
-If npm registry install is not available yet, install directly from GitHub:
+Fallback:
 
 ```bash
 npm install -g git+https://github.com/elvis1513/auto-coding-skill.git
 ```
 
-## Quick start (any repo)
+## Standard Workflow
 
-From your target repo root:
+1. Install skill into project:
 
 ```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
+# or claude / all
 ```
 
-Skill install locations:
-
-- `.claude/skills/auto-coding-skill`
-- `.codex/skills/auto-coding-skill`
-
-Then initialize the project scaffold (run one path that exists):
+2. Initialize docs and local scripts:
 
 ```bash
-python3 .claude/skills/auto-coding-skill/scripts/ap.py --repo . install
-# or
 python3 .codex/skills/auto-coding-skill/scripts/ap.py --repo . install
+# or
+python3 .claude/skills/auto-coding-skill/scripts/ap.py --repo . install
 ```
 
-This creates:
+3. Fill only one file manually:
+
+- `ENGINEERING.md` frontmatter
+
+This frontmatter is the only manual config source (commands + deployment + docs paths).
+
+4. Start AI development by constraints:
 
 - `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`
+- `docs/tasks/taskbook.md`
+- `docs/design/**`
+- `docs/interfaces/**`
+- `docs/testing/regression-matrix.md`
+- `docs/bugs/bug-list.md`
+- `docs/tasks/summaries/**`
+
+## AGENTS.md Constraint Example
+
+```md
+## Mandatory Skill
+- Always use `auto-coding-skill` for implementation tasks.
+- Before any code change, read and obey:
+  1) ENGINEERING.md
+  2) docs/tasks/taskbook.md
+- Execute gates using `python3 scripts/autopipeline/ap.py`.
+- If required docs are missing, create/update docs first, then code.
+```
 
-## Configure project commands
+## Commands
 
 ```bash
-cp docs/autocoding/config.example.yaml autocoding.config.yaml
+pip install pyyaml requests
+python3 scripts/autopipeline/ap.py run build
+python3 scripts/autopipeline/ap.py run test
+python3 scripts/autopipeline/ap.py run lint
+python3 scripts/autopipeline/ap.py verify-api-docs
+python3 scripts/autopipeline/ap.py check-matrix
+python3 scripts/autopipeline/ap.py gen-summary T0001-1
+python3 scripts/autopipeline/ap.py commit-push T0001-1 --msg "T0001-1: <summary>" --require-matrix
 ```
 
-Edit at least:
-
-- `commands.build`
-- `commands.test`
-- `commands.lint`
-- `commands.typecheck`
-- `commands.smoke`
-- `commands.regression`
+## Release New Version
 
-## Gate commands
+1. Bump version (cannot republish an existing version):
 
 ```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
+npm version patch
+# or: npm version minor
+# or: npm version major
 ```
 
-## CLI options
+2. Login and pre-check:
 
 ```bash
-autocoding init --ai claude|codex|all [--mode project|global] [--dest <path>] [--force]
+npm login
+npm whoami
+npm run release:check
 ```
 
-When `--ai all` and `--dest` are both used, output will be:
+3. Publish:
 
-- `<dest>/claude`
-- `<dest>/codex`
+```bash
+npm publish --access public --otp <6-digit-otp>
+```
 
-## Publish
+4. Verify release:
 
 ```bash
-npm login
-npm whoami
-npm run release:check
-npm publish --access public
+npm view @elvis1513/auto-coding-skill version
 ```
 
-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.
+5. Update installed clients:
+
+```bash
+npm install -g @elvis1513/auto-coding-skill@latest
+```
 
 ## License
 

package/cli/assets/skill/SKILL.md

@@ -1,73 +1,68 @@
 ---
 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.
+description: Use for strict project engineering workflow in Claude/Codex. Initialize docs, fill ENGINEERING.md frontmatter once, then execute design->implement->gates->summary->commit/push.
 ---
 
-# Auto Coding Skill (Claude + Codex Only)
-
-This skill is portable across projects and does not depend on any specific scaffold.
+# Auto Coding Skill (Claude + Codex)
 
 ## 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
+## Entry
 
-## Install into a target repo
-
-From the target repo root:
+1) Install skill files into target repo:
 
 ```bash
-# Claude Code
-autocoding init --ai claude
-
-# Codex CLI
 autocoding init --ai codex
-
-# Both
-autocoding init --ai all
+# or claude / all
 ```
 
-## Initialize project scaffold
-
-Run one of the following (depending on where the skill was installed):
+2) Initialize docs/tooling:
 
 ```bash
-python3 .claude/skills/auto-coding-skill/scripts/ap.py --repo . install
-# or
 python3 .codex/skills/auto-coding-skill/scripts/ap.py --repo . install
+# or .claude path
 ```
 
-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:
+3) Install runtime deps:
 
 ```bash
-cp docs/autocoding/config.example.yaml autocoding.config.yaml
+pip install pyyaml requests
 ```
 
-Set at least:
+## Single manual config source
+
+Fill only:
+
+- `ENGINEERING.md` frontmatter
+
+This contains all manual fields:
+- `commands.*`
+- `deployment.*`
+- `docs.*`
+
+Do not duplicate config in other md/yaml files.
+
+## Execution order
 
-- `commands.build`
-- `commands.test`
-- `commands.lint`
-- `commands.typecheck`
-- `commands.smoke`
-- `commands.regression`
+1) `ENGINEERING.md`
+2) `docs/tasks/taskbook.md`
+3) `docs/design/**`
+4) implementation
+5) run gates via `python3 scripts/autopipeline/ap.py`
+6) update API docs + regression matrix + bug list + summary
+7) commit/push
 
-## Common commands
+## 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
+python3 scripts/autopipeline/ap.py run build
+python3 scripts/autopipeline/ap.py run test
+python3 scripts/autopipeline/ap.py run lint
+python3 scripts/autopipeline/ap.py verify-api-docs
+python3 scripts/autopipeline/ap.py check-matrix
+python3 scripts/autopipeline/ap.py gen-summary T0001-1
+python3 scripts/autopipeline/ap.py commit-push T0001-1 --msg "T0001-1: <summary>" --require-matrix
 ```

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

@@ -1,3 +1,42 @@
+---
+project:
+  name: ""
+  repo_root: "."
+
+commands:
+  build: ""
+  test: ""
+  lint: ""
+  typecheck: ""
+  format: ""
+  smoke: ""
+  regression: ""
+
+deployment:
+  host: ""
+  ssh_port: 22
+  username: ""
+  password: ""
+  service_name: ""
+  systemd_dir: "/usr/lib/systemd/system"
+  remote_app_root: ""
+  remote_jar_path: ""
+  remote_config_dir: ""
+  remote_bin_dir: ""
+  health_base_url: ""
+  health_path: ""
+
+docs:
+  taskbook: "docs/tasks/taskbook.md"
+  design_dir: "docs/design"
+  review_dir: "docs/reviews"
+  api_doc: "docs/interfaces/api.md"
+  api_change_log: "docs/interfaces/api-change-log.md"
+  regression_matrix: "docs/testing/regression-matrix.md"
+  bug_list: "docs/bugs/bug-list.md"
+  summary_dir: "docs/tasks/summaries"
+---
+
 # ENGINEERING.md — AutoPipeline Gates (Source of Truth)
 
 目标：把一次任务固化为不可跳过的流水线：  
@@ -5,26 +44,25 @@
 部署(systemd/jar) → 重启验证 → 按API Markdown全量回归 + 回归矩阵0fail →  
 记录Bug并新增自动化回归 → 任务总结落盘 → commit → push
 
-规则：任一步骤失败或缺产物，禁止进入下一步；**未 push 视为任务未完成**，禁止开始下一个任务/子任务。
+规则：任一步骤失败或缺产物，禁止进入下一步；未 push 视为任务未完成，禁止开始下一个任务/子任务。
 
 ---
 
-## 0. 权威输入与冲突裁决（优先级）
-## 0.1 工程命令配置（必须）
+## 0. 配置填写（必须）
 
-- 构建/测试/静态分析/回归命令必须由项目提供并配置在：
-  - `autocoding.config.yaml`（推荐放 repo 根目录），或
-  - `docs/autocoding/config.yaml`
+先填写本文件 frontmatter 中的所有空值（例如 ip/用户名/密码/服务名/路径/命令）。  
+禁止在其他 md/yaml 重复维护这些配置。
 
-任何 gate 只允许通过这些配置的命令执行（避免把流程绑死在某个脚手架）。
+---
 
+## 1. 权威输入与冲突裁决（优先级）
 
 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）  
+6) docs/testing/regression-matrix.md（必须 0 FAIL）  
 7) docs/bugs/bug-list.md（长期积累，回归必测）  
 8) docs/tasks/summaries/**（每任务一份，强制产物）  
 9) docs/deployment/**  
@@ -32,32 +70,22 @@
 
 ---
 
-## 1. Gate 流水线（强制、不可跳过）
+## 2. Gate 流水线（强制、不可跳过）
 
 Gate-1 读任务：只从 taskbook 取范围与验收；缺信息先补 taskbook  
 Gate-2 写DD：无DD禁止写代码；DD必须含 时序图/ER图/接口时序（Mermaid）  
 Gate-3 实现：严格按DD；接口变更必须同步 API Markdown  
-Gate-4 本地CI：必须通过（ci-local）  
+Gate-4 本地CI：必须通过（commands.build / commands.test）  
 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-7 部署：单机 systemd/jar；service目录固定 /usr/lib/systemd/system；失败自动回滚  
 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
+Gate-9 全量回归：按 API Markdown 全量回归；回归矩阵全量 PASS（0 fail）；发现问题必须写 bug-list 并新增自动化回归用例  
+Gate-10 任务总结：必须生成 docs/tasks/summaries/<TASK_ID>.md  
+Gate-11 完成：全门禁通过后必须 commit+push
 
 ---
 
-## 3. Repo 工具入口（建议）
+## 3. Repo 工具入口
 
-统一用 `python3 tools/autopipeline/ap.py <command>` 执行。
+统一用 `python3 scripts/autopipeline/ap.py <command>` 执行。

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

@@ -1,11 +1,10 @@
 # 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（可配置）
+部署参数统一读取：`ENGINEERING.md` frontmatter
+- deployment.host / deployment.ssh_port / deployment.username / deployment.password
+- deployment.service_name / deployment.systemd_dir
+- deployment.remote_app_root / deployment.remote_jar_path / deployment.remote_config_dir / deployment.remote_bin_dir
+- deployment.health_base_url / deployment.health_path
 
 部署后必须：
 - smoke-test

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

@@ -1,10 +1,10 @@
 # Review — <Task ID> — YYYY-MM-DD HH:MM
 
 ## 1. 静态分析结果（必须）
-- Command：lint + typecheck（来自 autocoding.config.yaml）
+- Command：lint + typecheck（来自 ENGINEERING.md frontmatter）
 - Summary：
 - Issues：
-- Resolved/Deferred（deferred 必须 ADR）：
+- Resolved/Deferred（deferred 必须给出后续任务）：
 
 ## 2. 代码质量
 ## 3. 测试质量（含新增回归用例）

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

@@ -28,11 +28,12 @@
 - 回滚方式：
 
 ## 5. 质量门禁证据（必须可追溯）
+- 项目配置：`ENGINEERING.md`（frontmatter）
 - 本地CI：`ci-local`
 - 静态分析：`static`
 - Review 文档：`docs/reviews/<TASK_ID>-<timestamp>.md`
 - API 文档：`docs/interfaces/api.md`
-- 回归矩阵：`docs/requirements/regression-matrix.md`（全量 PASS，0 fail）
+- 回归矩阵：`docs/testing/regression-matrix.md`（全量 PASS，0 fail）
 
 ## 6. Bug 清单与回归用例
 - 新增/确认的 Bug（写入 `docs/bugs/bug-list.md`）：

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

@@ -18,13 +18,14 @@
   - [ ] T0001-2 <subtask>
 
 ### 证据（完成后填写）
+- 项目配置：`ENGINEERING.md`（frontmatter）
 - 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）
+- 回归矩阵：`docs/testing/regression-matrix.md`（全量PASS）
 - Bug清单（如有）：`docs/bugs/bug-list.md`
 - 任务总结（强制）：`docs/tasks/summaries/T0001.md`
 

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

@@ -26,13 +26,13 @@ def cmd_install(args: argparse.Namespace) -> None:
     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")
+    scripts_dir = repo / "scripts" / "autopipeline"
+    scripts_dir.mkdir(parents=True, exist_ok=True)
+    copy_tree(Path(__file__).resolve(), scripts_dir / "ap.py")
+    copy_tree(Path(__file__).resolve().parent / "core.py", scripts_dir / "core.py")
 
     gi = repo / ".gitignore"
-    secret_line = "docs/deployment/targets.yaml"
+    secret_line = "ENGINEERING.md"
     if gi.exists():
         txt = gi.read_text(encoding="utf-8")
         if secret_line not in txt:
@@ -41,11 +41,10 @@ def cmd_install(args: argparse.Namespace) -> None:
         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)")
+    print("[install] Next: edit ENGINEERING.md frontmatter and fill all project/env fields")
 
 
-def _infer_title(repo: Path, task_id: str) -> str:
-    taskbook = repo / "docs" / "tasks" / "taskbook.md"
+def _infer_title(taskbook: Path, task_id: str) -> str:
     if not taskbook.exists():
         return "<Title>"
     for line in taskbook.read_text(encoding="utf-8").splitlines():
@@ -60,14 +59,20 @@ def cmd_gen_summary(args: argparse.Namespace) -> None:
     repo = Path(args.repo).resolve()
     ensure_git_repo(repo)
     task_id = args.task_id
+    cfg = _load_cfg(repo)
+    docs_cfg = (cfg.get("docs") or {})
+    taskbook = Path(repo, str(docs_cfg.get("taskbook", "docs/tasks/taskbook.md")))
+    summary_dir = Path(repo, str(docs_cfg.get("summary_dir", "docs/tasks/summaries")))
+    api_change_log = str(docs_cfg.get("api_change_log", "docs/interfaces/api-change-log.md"))
+    regression_matrix = str(docs_cfg.get("regression_matrix", "docs/testing/regression-matrix.md"))
 
-    out_dir = repo / "docs" / "tasks" / "summaries"
+    out_dir = summary_dir
     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)
+    title = _infer_title(taskbook, task_id)
     date = _dt.date.today().isoformat()
 
     staged = run(["git", "diff", "--cached", "--name-only"], cwd=repo, check=False).stdout.strip()
@@ -99,14 +104,14 @@ def cmd_gen_summary(args: argparse.Namespace) -> None:
 ```
 
 ## 3. 接口变更（以 API Markdown 为准）
-- 变更记录位置：`docs/interfaces/api-change-log.md`
+- 变更记录位置：`{api_change_log}`
 
 ## 5. 质量门禁证据（必须可追溯）
 - 本地CI：TODO
 - 静态分析：TODO
 - Review 文档：TODO
 - DD 文档：TODO
-- 回归矩阵：`docs/requirements/regression-matrix.md`（全量 PASS，0 fail）
+- 回归矩阵：`{regression_matrix}`（全量 PASS，0 fail）
 """
 
     out_file.write_text(content, encoding="utf-8")
@@ -115,7 +120,9 @@ def cmd_gen_summary(args: argparse.Namespace) -> None:
 
 def cmd_check_matrix(args: argparse.Namespace) -> None:
     repo = Path(args.repo).resolve()
-    matrix = repo / "docs" / "requirements" / "regression-matrix.md"
+    cfg = _load_cfg(repo)
+    docs_cfg = (cfg.get("docs") or {})
+    matrix = Path(repo, str(docs_cfg.get("regression_matrix", "docs/testing/regression-matrix.md")))
     if not matrix.exists():
         raise APError(f"Matrix not found: {matrix}")
 
@@ -157,14 +164,18 @@ 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).
+    Commands are read from ENGINEERING.md frontmatter.
     """
     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)'}")
+        raise APError(
+            f"Command not configured: commands.{name}. "
+            "Edit ENGINEERING.md frontmatter. "
+            f"Available: {', '.join(commands.keys()) or '(none)'}"
+        )
     cmd = str(commands[name])
     print(f"[run] {name}: {cmd}")
     run_shell(cmd, cwd=repo)
@@ -187,15 +198,18 @@ def cmd_verify_api_docs(args: argparse.Namespace) -> None:
 def cmd_commit_push(args: argparse.Namespace) -> None:
     repo = Path(args.repo).resolve()
     ensure_git_repo(repo)
+    cfg = _load_cfg(repo)
+    docs_cfg = (cfg.get("docs") or {})
+    summary_dir = Path(repo, str(docs_cfg.get("summary_dir", "docs/tasks/summaries")))
 
     task_id = args.task_id
     msg = args.msg
 
-    summary = repo / "docs" / "tasks" / "summaries" / f"{task_id}.md"
+    summary = summary_dir / 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}"
+            f"Generate: python3 scripts/autopipeline/ap.py gen-summary {task_id}"
         )
 
     if args.require_matrix:

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

@@ -5,6 +5,7 @@
 from __future__ import annotations
 
 import os
+import re
 import shutil
 import subprocess
 from pathlib import Path
@@ -48,8 +49,18 @@ def load_yaml(path: Path) -> Dict[str, Any]:
         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)
+    if path.suffix.lower() in {".md", ".markdown"}:
+        text = path.read_text(encoding="utf-8")
+        m = re.match(r"^---\s*\n(.*?)\n---\s*(\n|$)", text, flags=re.DOTALL)
+        if not m:
+            raise APError(
+                f"Config markdown frontmatter not found: {path}\n"
+                "Expected YAML frontmatter wrapped by '---' at top of file."
+            )
+        data = yaml.safe_load(m.group(1))
+    else:
+        with path.open("r", encoding="utf-8") as f:
+            data = yaml.safe_load(f)
     return data or {}
 
 
@@ -84,20 +95,17 @@ def http_get_status(url: str, timeout_s: int = 5) -> int:
 
 
 def find_config(repo: Path) -> Path:
-    """Find autocoding config file (repo root preferred)."""
+    """Find single source project config file."""
     candidates = [
-        repo / "autocoding.config.yaml",
-        repo / "docs" / "autocoding" / "config.yaml",
-        repo / "docs" / "autocoding" / "config.yml",
+        repo / "ENGINEERING.md",
     ]
     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")
+    raise APError(
+        "Project config not found. Create ENGINEERING.md "
+        "and put commands + deployment fields in YAML frontmatter."
+    )
 
 
 def run_shell(command: str, cwd: Optional[Path] = None) -> None:

package/cli/src/index.js

@@ -64,7 +64,7 @@ function resolveTargetDir(ai, mode, destOverride){
 
 function ensureGitignore(projectDir){
   const gi = path.join(projectDir, ".gitignore");
-  const line = "docs/deployment/targets.yaml";
+  const line = "ENGINEERING.md";
   if (!exists(gi)) {
     fs.writeFileSync(gi, `${line}\n`, "utf-8");
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elvis1513/auto-coding-skill",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "CLI installer for auto-coding-skill (Claude Code + Codex CLI).",
   "type": "module",
   "bin": {

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

@@ -1,9 +0,0 @@
-# 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

@@ -1,35 +0,0 @@
-# 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/deployment/targets.example.yaml

@@ -1,23 +0,0 @@
-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/specs/security-baseline.md

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